int128 是 .net 8+ 引入的结构体，需 targetframework ≥ net8.0，不支持字面量初始化，必须用构造函数、parse/tryparse 或显式转换；运算默认不检查溢出，tostring 和解析性能低且格式受限。
Int128 在 C# 中不是语言内置类型，而是 .NET 8+ 引入的结构体（System.Int128），需目标框架 ≥ .NET 8 且引用 System.Runtime.dll —— 否则编译直接报错 CS0246。
Int128 只能在 .NET 8 及以上使用
很多开发者在 .NET 6 或 .NET 7 项目里写 Int128 x = 1;，结果编译失败。这不是语法问题，是类型根本不存在：Int128 是 System.Runtime.dll 中的新增类型，仅随 .NET 8（2023年11月发布）正式落地。若你用的是 Visual Studio 2022 v17.4+ 但 SDK 仍是 7.0，则必须显式升级项目文件中的 TargetFramework：
-
<targetframework>net8.0</targetframework>（或net9.0、net10.0） - 旧版
Microsoft.NET.Sdk不识别该类型，不支持隐式转换或字面量语法 - 即使安装了
System.RuntimeNuGet 包也无法补全 —— 类型由运行时提供，非纯库实现
不能直接用数字字面量初始化 Int128
Int128 不支持像 long 那样的后缀（如 123L），也没有 123i128 这种语法。所有初始化必须通过构造函数、静态方法或转换：
- ✅ 正确方式：
Int128 x = Int128.Parse("123456789012345678901234567890"); - ✅ 安全方式：
if (Int128.TryParse("...", out var x)) { ... } - ✅ 小值可转：
Int128 y = (Int128)int.MaxValue;或Int128 z = (Int128)long.MaxValue; - ❌ 错误写法：
Int128 a = 123456789012345678901234567890;（超出long范围，编译器先按long解析失败） - ❌ 错误写法：
Int128 b = 0x1234567890ABCDEF1234567890ABCDEF;（十六进制字面量同样受限于long上限）
Int128 的四则运算和比较要小心溢出语义
Int128 提供了标准算术操作符（+、-、*、/、%）和比较操作符（==、!=、、<code>> 等），但它们默认不检查溢出 —— 和 int/long 一样是“unchecked”语义：
- 乘法溢出不会抛异常，而是静默截断（例如两个接近上限的数相乘，结果可能为负）
- 需要溢出保护？得手动套
checked块：checked { var r = a * b; } -
Int128.DivRem是唯一能同时拿到商和余数的方法：var (q, r) = Int128.DivRem(a, b); - 比较操作符（如
==）已重载，直接可用；但注意null比较无意义 ——Int128是值类型，不可能为null
ToString 和解析是高频痛点，别依赖默认格式化
Int128.ToString() 能工作，但性能差、不支持自定义格式（如千分位、科学计数法）。更关键的是：TryParse 系列方法只接受字符串、ReadOnlySpan<char></char> 或 UTF-8 ReadOnlySpan<byte></byte>，不支持 Span<char></char> 或 Memory<char></char>：
- ✅ 推荐解析路径：
Int128.TryParse(input.AsSpan(), out var val)（避免 string 分配） - ✅ 大量解析场景下，优先用 UTF-8：
Int128.TryParse(utf8Bytes, out var val) - ⚠️ 注意文化敏感性：
TryParse(string, out x)使用当前线程文化，可能导致逗号/点解析错误；明确传CultureInfo.InvariantCulture - ❌ 不要尝试用
string.Format或$"{x:N}"—— 格式说明符未实现，会退化为ToString()原始输出
真正麻烦的从来不是“能不能算”，而是“怎么安全地进、怎么可控地出”。Int128 没有字面量、没有高效 I/O 原语、不参与泛型数学接口（如 INumber<t></t> 在 .NET 8 中尚未包含它），这些限制在做高吞吐数值处理时会立刻暴露。别把它当“大号 long”用，而要当成一个需谨慎握手的独立数值域。
