readonlyspan适用于短时、只读、高频切片解析场景;安全创建仅限asspan()、stackalloc或byte[]转换;禁止跨await、作字段或隐式转string。

ReadOnlySpan
什么时候该用 ReadOnlySpan 而不是 string
核心判断标准就一条:你是否只做「短时、只读、高频」的切片解析?比如:
- HTTP header 行里找
:分隔符并提取值(line.IndexOf(':')+line.Slice()) - CSV 行按
,拆字段,且每个字段只用来int.TryParse()或比对字面量 - 日志行中提取时间戳、状态码、路径段——不存、不拼接、不传给老框架
反例:要塞进 ViewBag、要序列化成 JSON、要缓存 5 秒以上、要跨 await 传递——这些都得用 string 或 ReadOnlyMemory<char></char>,硬上 ReadOnlySpan<char></char> 会编译失败或运行时崩溃。
创建 ReadOnlySpan 的安全方式 vs 常见踩坑
源头决定一切。以下写法看似合理,实则已触发堆分配,性能归零:
- ❌
new ReadOnlySpan<char>(someString.ToCharArray())</char>—— 数组分配 + 复制,双重浪费 - ❌
someString.Substring(10, 5).AsSpan()——Substring先建新string,再转Span已晚 - ❌
someString.AsSpan().ToString()在函数开头就调 —— 前面所有优化白做
正确做法只有三种:
- ✅ 直接从
string创建:someString.AsSpan()(安全,无额外分配) - ✅ 从栈数组创建:
stackalloc char[256]后用new ReadOnlySpan<char>(ptr, len)</char> - ✅ 从
byte[]或文件流读取后创建:stream.Read(buffer); var span = buffer.AsSpan(0, bytesRead)
切片、索引、越界检查的实战细节
Slice(start, length) 容易被当成 [start..end) 用,但它真义是「从 start 开始取 length 个字符」。越界在 Release 模式下不抛异常,直接崩。
- 输入
"abcde",span.Slice(3, 5)→ 索引 3 开始取 5 个 → 实际需要长度 8 →IndexOutOfRangeException - 外部数据(如解析位置)必须手动截断:
var safeLen = Math.Min(requestedLen, input.Length - start),别依赖 try/catch - C# 8+ 推荐用范围语法:
input[3..8]语义清晰,底层仍是Slice,但编译器帮你算长度 -
input[3..]和input[..5]是合法的,但input[^3..](倒序索引)需注意^运算本身有开销,高频热路径慎用
传参和返回值的生命周期红线
ReadOnlySpan<t></t> 是 ref struct,只能存在栈上,不能逃逸到堆。这意味着:
- ❌ 不能作为类字段、不能存进
List<readonlyspan>></readonlyspan>、不能赋值给object或dynamic - ❌ 不能在
async方法里跨await使用——编译器报错:Cannot use local 'span' in this context because it would escape the method body - ✅ 函数签名必须声明为
void Parse(ReadOnlySpan<char> input)</char>,调用方传str.AsSpan()即可 - ✅ 返回值只能是
ReadOnlySpan<t></t>的子切片(仍绑定原内存),不能返回新分配内容;真要返回,用ReadOnlyMemory<t></t>或string
最常被忽略的一点:哪怕你全程没调 ToString(),只要把 ReadOnlySpan<char></char> 传给了一个接受 string 的 API(比如某个日志库的 Log(string msg)),编译器就会自动插入隐式转换,立刻分配。










