VSCode格式化C#失败主因是OmniSharp服务未启动或与项目/.NET SDK不匹配；需检查状态栏、输出日志、settings.json配置（如omnisharp.useModernNet）、.editorconfig位置及字段名、文件是否在有效项目结构中。
VSCode格式化C#代码失败，根本原因几乎都落在OmniSharp服务没跑起来，或它和项目、.NET SDK之间“对不上号”。
OmniSharp服务是否在运行？看日志最准
右下角状态栏如果没显示 OmniSharp: Ready，或者一直卡在 Starting OmniSharp...，说明服务压根没起来。这时候别猜，直接看日志：
- 打开 VS Code 的 输出（Output）面板（
Ctrl+Shift+U），下拉选择OmniSharp Log - 重点扫一眼有没有红色错误行，比如：
Failed to load project file、Could not find .NET SDK、MSBuild not found - 常见诱因：项目里有损坏的
.csproj，或global.json指向了一个本机不存在的 SDK 版本
settings.json 里这几个配置不能乱动
VS Code 的用户或工作区设置（settings.json）中，以下几项直接影响格式化能否触发：
-
"omnisharp.useModernNet": true—— 必须开。.NET 6+ 项目依赖这个开关启用新版 Roslyn 后端，关了就可能连基础格式化都不响应 -
"omnisharp.enableEditorConfigSupport": true—— 如果项目根目录有.editorconfig，必须开；否则 OmniSharp 会忽略你写的缩进、空格等规则 -
"editor.formatOnSave": true和"[csharp]": { "editor.defaultFormatter": "ms-dotnettools.csharp" }—— 这两项是触发入口，缺一不可 - 慎用
"omnisharp.path"：除非你手动编译/下载了特定版本 OmniSharp，否则留空让插件自动管理更稳；填错路径会导致整个服务启动失败
格式化命令没反应？检查文件上下文
按 Shift+Alt+F（Windows）或 Shift+Option+F（macOS）没反应，不一定是插件坏了，先确认当前文件是否被 OmniSharp “认作 C#”：
- 文件后缀必须是
.cs，且所在文件夹里得有有效的.sln或.csproj（哪怕只是空壳） - 如果文件是孤立的（比如临时新建一个
test.cs放在桌面），OmniSharp 不会加载它，格式化自然无效 - 右键菜单里如果灰色不可点
Format Document，大概率是语言模式没识别对：按Ctrl+Shift+P→ 输入Change Language Mode→ 选C#
.editorconfig 规则被忽略？优先级和字段名要对得上
写了 indent_size = 4 却还是缩进 2 格，问题往往出在匹配范围或字段名拼写：
- 确保
.editorconfig在项目**根目录**（即包含.sln或.csproj的那一层），OmniSharp 不会向上跨多层查找 - C# 专用规则必须包在
[*.cs]段落里，写成[*]或[*.cpp]都不生效 - 字段名必须严格匹配：用
indent_size，不是tab_width（后者只影响 tab 显示，不控制格式化行为）；用end_of_line = lf，不是line_ending - 如果同时启用了
omnisharp.useModernNet，部分旧版.editorconfig字段（如csharp_indent_block_contents）可能已被弃用，建议参考 OmniSharp 官方 editorconfig 文档
OmniSharp 的格式化不是“开个开关就完事”的黑盒——它依赖项目结构、SDK 版本、配置文件位置和字段名四者严丝合缝。最容易被跳过的，是 .editorconfig 文件放错位置，以及孤立 .cs 文件不被加载这两点。
