VS Code中Flutter代码格式化配置及保存自动格式化异常求助

Hey there, sorry to hear you're stuck with this formatting issue—it's so frustrating when your manually tweaked code gets messed up every time you hit save! Let's walk through some common fixes to get this sorted.

First, let's recap your situation to make sure I understand correctly:

我希望保存文件时应用自己想要的代码格式
但实际保存后格式却被改变，哪怕我已经手动把代码调整成喜欢的样式
已按照Flutter文档推荐安装了Flutter扩展，当前设置如图

核心排查与修复步骤 #

• 指定Dart文件的默认格式化工具
  有时候VS Code里的其他格式化扩展（比如Prettier）会和Dart官方的格式化工具冲突。打开VS Code的settings.json（可以通过命令面板运行Preferences: Open Settings (JSON)打开），添加这段配置：

  "[dart]": {
    "editor.defaultFormatter": "Dart-Code.dart-code",
    "editor.formatOnSave": true,
    "editor.formatOnSaveMode": "file"
  }
  

  这样就能强制Dart文件只使用官方的Dart格式化工具，避免其他工具干扰你的格式偏好。

• 自定义Dart格式化规则
  如果是对默认的Dart格式化样式不满意（比如行宽、缩进、换行逻辑），可以在settings.json里添加自定义规则来贴近你想要的效果：

  "dart.formatter.lineLength": 120, // 调整允许的最大行宽
  "dart.formatter.indent": 2, // 缩进空格数（默认是2，可按需修改）
  "dart.formatter.pageWidth": 120
  

  这些配置会覆盖Dart格式化工具的默认行为，让输出更符合你的个人偏好。

• 检查保存格式化的全局与局部开关
  确保全局和Dart文件的formatOnSave设置都是开启的，避免局部设置意外覆盖了全局规则：

  "editor.formatOnSave": true,
  "[dart]": {
    "editor.formatOnSave": true
  }
  

• 排查扩展与缓存问题

  • 尝试禁用再重新启用Dart和Flutter扩展，然后重启VS Code——有时候扩展缓存会导致奇怪的格式化异常
  • 检查扩展是否有更新，旧版本的Dart/Flutter扩展可能存在格式化逻辑的bug，更新到最新版本通常能解决不少这类问题

额外排查小贴士 #

• 打开VS Code的「问题」面板（快捷键Ctrl+Shift+M/Cmd+Shift+M），看看有没有Dart lint规则的提示——有些lint规则会强制代码格式，可能导致你手动调整的格式被自动覆盖
• 手动运行一次Dart: Format Document（命令面板里搜索这个命令），看看这个手动格式化的结果和保存后的结果是否一致。如果不一致，说明保存时触发了其他额外的格式化逻辑，比如lint自动修复，这时候可以检查editor.codeActionsOnSave的配置，尝试暂时关闭自动修复来排查：

  "editor.codeActionsOnSave": {
    "source.fixAll": false,
    "source.fixAll.dart": false
  }
  

备注：内容来源于stack exchange，提问作者niko craft