global.json用于主动指定项目使用的.net sdk版本，而非解决冲突；它通过严格匹配文件名、位置和json格式生效，锁定构建工具链版本以保障环境一致性。
global.json 不是用来“解决冲突”的，而是用来“主动指定”项目该用哪个 SDK 版本——它本身不消除冲突，但能避免你被默认版本带偏。
为什么 dotnet --version 和项目实际用的 SDK 版本不一致
这是最常被误解的点：dotnet --version 显示的是当前 shell 环境下“默认选中的 SDK”，而项目真正用哪个 SDK，取决于 global.json 文件是否存在、位置是否正确、内容是否合法。
常见错误现象：
- 你在根目录执行
dotnet --version得到 9.0.100，但项目 build 失败，报错NETSDK1045 - VS Code 的 OmniSharp 提示找不到
Microsoft.NET.Sdk，但dotnet --list-sdks明明列出了对应版本
根本原因：项目目录或其任意上级目录中没有 global.json，或文件名写成 Global.json / GLOBAL.JSON（Windows 下可能侥幸通过，Linux/macOS 下直接失效）；又或者 global.json 放在了子模块或生成目录里，不在项目逻辑根路径。
必须满足三个条件才生效：
- 文件名严格为
global.json（全小写） - 位于项目
.csproj所在目录，或其任意父目录（就近原则） - JSON 格式合法，且只包含
sdk字段（其他字段如msbuild-sdks会触发解析失败）
怎么写一个真正起作用的 global.json
不要手写 JSON——容易漏逗号、引号不匹配、字段拼错。用 CLI 生成最稳妥：
dotnet new globaljson --sdk-version 8.0.302 --roll-forward disable
生成后检查内容是否符合预期：
-
version必须是完整三段式（如8.0.302），不能写成8.0或8 -
rollForward推荐设为"disable"，尤其在工业、Godot、串口上位机等对行为一致性要求高的场景；"latestFeature"虽灵活，但可能跨大版本引入不兼容变更 - 删掉所有注释（JSON 不支持）、多余空格、隐藏 Unicode 字符（比如从网页复制时带入的零宽空格）
验证是否生效：
cd /your/project/root<br>dotnet --version
如果输出和 global.json 里写的 version 一致，说明已锁定成功；否则检查路径层级或运行终端是否是全新会话（旧终端可能缓存了 PATH 或环境变量）。
global.json 锁定的是 SDK，不是运行时——别混淆这两者
很多人以为配了 global.json 就能控制程序跑在哪个 .NET 运行时上，其实完全不是一回事：
-
global.json只影响dotnet build、dotnet run、dotnet test这些 CLI 命令调用的编译器和 MSBuild 版本 - 运行时版本由项目文件里的
<targetframework>net8.0</targetframework>决定，最终绑定到系统已安装的对应运行时（dotnet --list-runtimes查看） - 即使
global.json指定6.0.400，只要.csproj是net8.0，构建出来的程序仍需 .NET 8 运行时才能运行
典型误操作：
- 为 net6.0 项目配了
global.json指向 8.0.302 → 构建可能成功，但某些新 SDK 的分析器会误报警告 - 为 net8.0 项目配了
global.json指向 6.0.400 → 构建直接失败，因为老 SDK 不认识net8.0这个 TargetFramework
多项目共存时，global.json 的作用域和陷阱
global.json 的作用范围是“所在目录及其所有子目录”，没有例外。这意味着：
- 如果你在
/workspace/下放了一个global.json，那么/workspace/project-a/和/workspace/project-b/都会受它影响——除非各自目录下再放一个更近的global.json - Git 子模块、nuget 包缓存目录、
bin/或obj/目录里出现global.json是危险信号，可能导致构建行为意外改变 - CI/CD 流水线中，如果工作目录结构和本地不一致（比如 checkout 到
/home/runner/work/repo/repo），global.json是否被正确检出、路径是否匹配，必须显式验证
最容易被忽略的一点：VS Code 的 C# 扩展（OmniSharp）默认会读取 global.json，但它有自己的缓存机制。修改 global.json 后，必须手动触发 OmniSharp: Restart OmniSharp（Ctrl+Shift+P），否则编辑器内看到的智能提示、错误诊断仍基于旧 SDK。
