VSCode中C#代码格式化效果不佳，如何实现严格格式化？

问题场景 #

长时间未编写C#代码，重新搭建了.NET SDK + VSCode+C#扩展环境，代码可正常运行，但格式化仅执行基础操作，无法修正长代码行、参数换行对齐、单行多变量声明等不规范格式。示例代码：

// This is a very very very very very very very very very very very very very very very very very very very very very very very very very very very very long line
void Foo(double x, double y)
{
}

Foo(1,
          2);

var y = 42; var z = 1;

期望格式化后达到：

// This is a very very very very very very very very very very very very very very very very very very very very very very very very very very very very long line
void Foo(double x, double y)
{
}

Foo(1, 2);
// 或
Foo(1,
    2);

var y = 42;
var z = 1;

已确认VSCode中Csharp>Format:Enable为true，语言服务正常，项目包含test.csproj文件，需解决严格格式化问题。

解决方案 #

1. 项目根目录添加.editorconfig文件 #

C#代码格式化优先遵循.editorconfig配置，这是实现严格格式化的核心。在项目根目录创建该文件，添加以下关键配置：

root = true

[*.cs]
# 禁止单行多个变量/字段声明，强制拆分到单独行
csharp_style_single_line_declaration = false:error
# 方法参数换行后对齐到第一个参数的位置
csharp_align_multiline_parameters = true
# 设置最大行长度，超过自动换行
dotnet_max_line_length = 120
# 保留单行代码块（如空方法的{}不换行）
csharp_preserve_single_line_blocks = true
# 不保留单行多语句（拆分单行多个语句到独立行）
csharp_preserve_single_line_statements = false

2. 配置VSCode的C#扩展 #

打开VSCode设置（快捷键Ctrl+,），调整以下选项：

• 开启Csharp > Formatting > Format On Save：保存文件时自动执行格式化
• 设置Csharp > Formatting > Preferred Formatting Style为EditorConfig：确保扩展优先使用.editorconfig的规则
• 确认Csharp > Formatting > Enable Editor Config Support为启用状态

3. 验证格式化效果 #

添加并保存.editorconfig后，重启VSCode，打开目标代码文件：

• 手动触发格式化：按Ctrl+Shift+I
• 或直接保存文件，查看代码是否符合预期格式

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