VSCode中Flutter格式化禁止自动移除尾随逗号及换行的方法

问题原因 #

你之前配置的require_trailing_commas是代码检查规则，仅用于提示缺少尾随逗号，不控制格式化工具的合并行为。格式化时的行合并、逗号移除是由Dart官方格式化工具dartfmt和VSCode的Dart插件设置决定的。

具体解决步骤 #

1. 调整VSCode的Dart插件格式化设置

打开VSCode设置面板（快捷键：Windows/Linux Ctrl+,，Mac Cmd+,），搜索并设置以下选项：

• Dart: Formatter Line Length：设为和你editor.rulers相同的值（比如80）
• Dart: Formatter Prefer Single Line：设置为false，禁止自动把多行代码合并为单行
• Dart: Formatter Fix Trailing Commas：设置为true，确保尾随逗号被保留

也可以直接在settings.json中添加配置：

{
  "dart.formatter.lineLength": 80,
  "dart.formatter.preferSingleLine": false,
  "dart.formatter.fixTrailingCommas": true
}

2. 完善analysis_options.yaml配置

在项目根目录的analysis_options.yaml中添加格式化规则，让dartfmt遵循你的要求：

linter:
  rules:
    require_trailing_commas: true

formatter:
  line_length: 80
  prefer_single_line: false

3. 刷新配置生效

按Ctrl+Shift+P（Mac Cmd+Shift+P），选择「Reload Window」重启VSCode窗口，确保配置生效。

这样设置后，格式化工具就会保留你原来的换行和尾随逗号，不会再把短行合并成单行。

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