<p>OmniSharp Atom 是唯一支持 C# 调试的 Atom 插件，依赖 OmniSharp 服务器提供断点、变量监视和单步执行功能；其他插件仅能运行程序，无法实现真正调试；需 .NET SDK 6.0+、有效 .csproj 项目结构及状态栏火焰图标变绿方可启用。</p>
OmniSharp Atom 是唯一可行的 C# 调试支持插件
Atom 本身不支持调试，C# 的断点、变量监视、单步执行等功能全依赖omnisharp-atom 插件 + 后端 OmniSharp 服务器协同实现。其他插件（如 script、gpp-compiler）只能运行编译后程序，无法停在断点、查看局部变量或调用栈。如果你看到“F9 无反应”“右键没有 Debug 选项”，基本说明 omnisharp-atom 没装好，或项目结构不被识别。
- 必须使用 .NET SDK（6.0+ 推荐），不能只靠 Mono 或旧版 .NET Framework
- 项目根目录下要有
.csproj文件，纯.cs单文件不会触发 OmniSharp 启动调试能力 - 安装后需重启 Atom，且首次打开 C# 项目时底部状态栏要等火焰图标变绿，才表示服务器就绪
- Windows 用户若用 PowerShell 启动 Atom，需确保
$env:Path包含dotnet所在路径（通常为C:\Program Files\dotnet\）
调试前必须确认项目结构和启动配置
OmniSharp Atom 不会自动猜你“想调试哪个入口”。它只响应标准 .NET 项目结构，并依赖launch.json（VS Code 风格）或 .vscode/ 目录——但注意：omnisharp-atom **根本不读取 launch.json**。它的调试入口由项目类型决定：
- 控制台应用：自动识别
Main方法，按F5启动调试 - ASP.NET Core：需项目包含
Program.cs+Startup.cs（或 6.0+ 的 Minimal Hosting 模式），且dotnet run能成功启动 - 类库（.dll）项目：无法直接调试，必须关联到可执行项目（如引用它的控制台项目）
- 若状态栏显示 “No debug adapter available”，大概率是
.csproj中缺失<TargetFramework>net6.0</TargetFramework>或拼写错误
常见调试失败现象与直击原因
调试中途崩溃、断点灰色不可用、F5 后无反应——这些问题几乎都出在环境链路断裂，而非代码逻辑：- 断点显示为空心圆（未命中）：
omnisharp-atom没加载对应 PDB 符号文件，检查是否启用了<DebugType>portable</DebugType>（.csproj 中默认开启，但手动删过就会失效） - 控制台输出中文乱码（Windows）：不是编码问题，而是
dotnet运行时默认用系统区域设置；临时解法是在终端执行chcp 65001后再启动 Atom - F5 按下后状态栏闪红又恢复：
omnisharp-atom尝试调用dotnet build失败，打开 Atom 底部的OmniSharp Log面板，看最后一行是否含MSB*错误（如MSB3644表示找不到 .NET SDK 引用组件） - 变量窗口显示 “Unable to evaluate expression”：调试器已运行，但当前栈帧没符号信息——常见于 Release 模式编译，确保
<Configuration>Debug</Configuration>且<Optimize>false</Optimize>
调试体验远弱于 VS / VS Code，别强求完整功能
omnisharp-atom 提供的是基础调试能力：设断点、F10/F11 单步、查看局部变量、调用堆栈。它不支持条件断点、日志断点、内存视图、线程切换、即时窗口（Immediate Window）或 Attach to Process。如果你需要这些，要么切到 VS Code（用 ms-dotnettools.csharp 插件），要么直接上 Visual Studio。
真正容易被忽略的一点：Atom 的调试会话无法热重载（Hot Reload）。每次改完代码必须停止调试、重新 F5。而 VS Code 的 C# 插件在 .NET 6+ 项目中支持修改后自动应用变更——这点差异在日常开发中比想象中影响更大。
