VS Code保存新Dart项目文件时自动移除尾随逗号及代码压缩问题咨询

核心原因 #

这不是VS Code的新特性，而是Dart官方格式化工具dart format的规则生效逻辑变化——当代码无尾随逗号且行长度未超过阈值时，会自动将多行代码合并为一行；反之，若存在尾随逗号，即使行长度较短，也会保持每行一个参数的布局。你的情况大概率是格式化配置被默认调整为移除尾随逗号，或是行长度阈值设置过低。

具体解决步骤 #

1. 调整VS Code中的Dart格式化基础配置
   打开VS Code设置界面（快捷键Ctrl+, / Cmd+,），搜索并修改以下选项：

   • Dart: Line Length：将默认的80调整为更大的值（比如120或150），减少长行被强制合并的概率。
   • Dart: Format On Save：确认该选项处于启用状态（当前问题由格式化触发，需确保配置调整后能按新规则生效）。

2. 强制保留尾随逗号的格式化规则
   打开用户或工作区的settings.json文件（可通过设置界面右上角的「打开设置(JSON)」按钮进入），添加以下配置，让格式化工具自动保留尾随逗号，避免代码被合并：

   "dart.preferences": {
     "format.useTrailingCommas": "always"
   }
   

   该配置会让dart format在格式化时自动为多行代码的末尾添加尾随逗号，从而维持每行一个参数的布局，不会被压缩成单行。

3. 排查项目级格式化规则冲突
   部分项目会在根目录下的analysis_options.yaml文件中定义自定义格式化规则，打开该文件检查是否存在与尾随逗号、换行相关的冲突规则，比如：

   linter:
     rules:
       - prefer_no_trailing_commas
   

   若有此类规则，直接修改或移除即可。

4. 重置Dart分析服务器状态
   打开VS Code命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入Dart: Restart Analysis Server并执行；之后关闭VS Code，删除项目根目录下的.dart_tool文件夹，重新打开项目即可。

验证效果 #

修改配置后，编写一段带多参数的Flutter布局代码（如Container或Column），保存后确认代码不会被压缩成一行；即使手动遗漏了尾随逗号，格式化工具也会自动补上，保持多行布局。

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