sublime text 运行 c# 依赖本地已安装并全局可用的 .net sdk；必须用含 .csproj 的项目目录、纯英文无空格路径，并配置正确 build system 指向项目根目录。
Sublime Text 本身不能编译或运行 C#，它只是编辑器；所有“运行”动作都依赖你本地是否装好 dotnet CLI（即 .NET SDK），且该命令必须能在终端中直接执行。没装 SDK，配什么都白搭——这是 90% 失败的根源。
确认 dotnet 已正确安装并全局可用
Sublime 的构建系统本质是调用 shell 命令，如果终端里输 dotnet --version 报错或无输出，Sublime 就不可能跑起来。
- Windows：安装时务必勾选 “Add to PATH”，或手动把
C:\Program Files\dotnet加入系统环境变量；安装后**彻底退出 Sublime 进程**（不是关窗口），再重开 - macOS：用
brew install dotnet-sdk或官网下载 pkg；若终端能运行但 Sublime 不行，说明图形界面启动没读取 shell 配置——改用终端命令启动：subl . - Linux：检查
~/.bashrc或~/.zshrc是否 source 了 dotnet 路径；临时验证可把 Build System 中的"cmd"换成"shell_cmd": "dotnet run"，但会丢失错误行定位 - 验证方式：打开任意终端，执行
dotnet --version，输出应类似8.0.300；若提示command not found，别往下走
必须用 .csproj 项目，不能只开单个 .cs 文件
现代 .NET（5+）已弃用裸 csc 编译单文件的方式。dotnet run 只认项目目录下的 .csproj，否则必报 MSB1009: Project file does not exist。
- 在终端中创建标准项目：
dotnet new console -n MyApp，然后cd MyApp - 用 Sublime 打开整个文件夹（
File → Open Folder…），不是双击打开Program.cs - 确保文件夹里有
MyApp.csproj和Program.cs，且Program.cs含有效入口（如顶层语句或static void Main） - 中文路径、空格路径会导致
dotnet解析失败，项目请放在C:/dev/或~/code/这类纯英文无空格路径下
配置正确的 Build System（CSharp.sublime-build）
这个 JSON 文件决定按 Ctrl+B 时 Sublime 执行什么命令。关键不是写得多 fancy，而是 working_dir 必须指向项目根目录。
- 菜单栏 →
Tools → Build System → New Build System… - 粘贴以下内容（Windows/macOS/Linux 通用，不用改分隔符）：
{
"cmd": ["dotnet", "run"],
"selector": "source.cs",
"working_dir": "${project_path:${folder}}",
"variants": [
{
"name": "Build",
"cmd": ["dotnet", "build"]
}
]
}
- 保存为
CSharp.sublime-build（后缀名必须是.sublime-build） - 保存后，在
Tools → Build System中选中CSharp -
working_dir用${project_path:${folder}}是为了兼容“打开文件夹”和“打开项目”的两种场景；若用${file_path}，打开Program.cs时会进错目录，找不到.csproj - 别加
"shell_cmd"：它绕过 Sublime 的错误解析机制，导致编译失败时看不到具体哪行出错
常见报错及对应解法
按 Ctrl+B 没反应或报错，多数不是配置问题，而是环境或路径问题。
-
空白面板、无任何输出→ 终端运行dotnet --version看是否成功；失败则回第一步 -
MSBUILD : error MSB1009: Project file does not exist.→ 当前文件不在含.csproj的目录里；确认已用Open Folder打开项目根目录 -
The build failed. Fix the build errors…→ 看输出里带行号的错误（如Program.cs(5,12): error CS1002:），Sublime 不做语法检查，全靠dotnet build反馈 -
'dotnet' is not recognized as an internal or external command（Windows）→ 不是 Sublime 配置错，是系统 PATH 没生效；重启电脑或至少重启 Sublime 进程 - 想快速测代码片段？别硬套项目流程：
dotnet script是另一套机制，需单独dotnet tool install -g dotnet-script，和本文 Build System 无关
最易被忽略的点：Sublime 启动方式影响环境变量继承（尤其 macOS/Linux 图形界面）、项目路径含空格或中文、以及误以为“打开 .cs 文件 = 打开项目”。这些不解决，JSON 写得再准也没用。
