需实现 iutf8spanformattable 以避免 tostring() 和 encoding.utf8.getbytes() 导致的两次堆分配，通过 tryformat 直接写入 span，手写 utf-8 编码逻辑，严格校验目标容量并禁止任何内存分配操作。
为什么需要实现 IUtf8SpanFormattable
当你在高性能场景（如 HTTP 响应序列化、日志批量写入）中频繁调用 ToString() 并转成 UTF-8 字节数组时，会触发字符串分配 + Encoding.UTF8.GetBytes() 两次堆分配。而 IUtf8SpanFormattable 允许你绕过字符串，直接把值格式化进 Span<byte></byte>，避免 GC 压力。它不是“锦上添花”，而是高吞吐服务里降低延迟的关键路径优化。
TryFormat 方法签名和核心约束
必须实现 bool TryFormat(Span<byte> destination, out int bytesWritten, ReadOnlySpan<char> format, IFormatProvider? provider)</char></byte>。注意三点：
-
destination容量可能不足，必须先计算所需字节数（不能硬编码长度），再比较destination.Length；不足就返回false，不写任何字节 - 不能调用任何会分配内存的方法（如
string.Create、Encoding.UTF8.GetBytes(string)、ReadOnlySpan<char>.ToArray()</char>） - UTF-8 编码逻辑必须手写：ASCII 字符直接写入，Unicode 字符需按 UTF-8 规则展开为 2~4 字节（例如
'€'是0xE2 0x82 0xAC）
示例：一个只含 ASCII 的简单类型可这样写：
public bool TryFormat(Span<byte> destination, out int bytesWritten, ReadOnlySpan<char> format, IFormatProvider? provider)
{
if (destination.Length < 3) // 假设最多输出 "123"
{
bytesWritten = 0;
return false;
}
var value = this.Value; // 假设是 int
bytesWritten = 0;
// 手写整数转 ASCII 字节（简化版，实际要用 RyuJIT 内置的 Number.Formatting）
if (value == 0)
{
destination[0] = (byte)'0';
bytesWritten = 1;
return true;
}
// … 省略完整整数格式化逻辑（推荐复用 <code>System.Numerics.BigInteger.TryWriteBytes</code> 或 <code>Utf8Formatter</code> 静态方法）
return true;
}
如何安全复用 .NET 内置 UTF-8 格式化逻辑
自己手写所有类型的 UTF-8 编码极易出错（尤其浮点、日期、带 culture 的数字）。.NET 6+ 提供了可靠的底层支持：
