.NET 8跨平台编译异常：Linux Docker中string.Split出现CS0121歧义错误

问题场景 #

本地Windows环境使用.NET 8 SDK编译代码可正常通过，但在Linux Docker容器中使用相同SDK编译失败。其中request.SearchText属性类型为string?。

原代码：

var searches = request.SearchText?.Split([',',' ',';','
'], 
           StringSplitOptions.TrimEntries |
           StringSplitOptions.RemoveEmptyEntries).ToList() ?? [];

编译错误信息 #

Linux Docker环境中收到的编译错误：

error CS0121: The call is ambiguous between the following methods or 
properties: 'string.Split(char[]?, StringSplitOptions)' and 
'string.Split(string?, StringSplitOptions)' [/src/....]

修复方案 #

显式声明分隔符为char[]类型，即可消除编译器的重载解析歧义：

char[]? separator = [',',' ',';','
'];
var searches = request.SearchText?
    .Split(separator, StringSplitOptions.TrimEntries | 
     StringSplitOptions.RemoveEmptyEntries)
    .ToList() ?? [];

原因解析 #

这个跨平台编译差异的核心原因是数组字面量的类型推断受平台换行符处理逻辑影响：

• Windows环境下，代码中的换行字符会被编译器明确解析为单个char类型，因此数组字面量[',',' ',';','\n']会被推断为char[]，精准匹配string.Split(char[]?, StringSplitOptions)重载，无歧义。
• Linux环境下，换行符格式为LF（与Windows的CRLF不同），若代码在跨平台同步时出现换行符转换（比如Git的autocrlf配置），或编译器对数组字面量中换行字符的解析逻辑存在细微差异，会导致编译器无法明确推断数组类型是char[]还是string[]。加上string.Split同时存在接受char[]和string[]的重载，最终触发歧义错误。

此外，项目规模较大时，可能存在的其他变量（如不同的NuGet包版本、编译配置细节、自定义扩展方法等）也可能间接干扰编译器的重载解析逻辑，但显式声明数组类型是最直接的消除歧义方式。

内容的提问来源于stack exchange，提问作者Jace Rhea