Flutter开发：如何确保团队在VSCode与Android Studio中用统一格式化规则？

核心方案：统一使用Flutter官方格式化工具 #

不管用VSCode还是Android Studio，直接绑定Flutter自带的flutter format工具是最可靠的统一标准——这是Flutter官方维护的格式化逻辑，完全规避IDE自定义规则的差异。

VSCode配置 #

打开设置（快捷键Ctrl+,/Cmd+,），搜索并设置：

• editor.defaultFormatter: 选择Dart-Code.dart-code（官方Dart插件，会调用flutter format）
• editor.formatOnSave: 勾选，确保保存时自动格式化
• dart.useFlutterFormat: 设置为true，强制使用Flutter专属格式化规则而非Dart单独规则

Android Studio配置 #

打开Settings（快捷键Ctrl+Alt+S/Cmd+,），依次进入Languages & Frameworks > Flutter > Formatting：

• 勾选Use flutter format
• 切换到Editor > General > Editor Tabs，勾选Reformat code on save，下拉选项指定.dart文件
• 无需手动修改Editor > Code Style > Dart的规则，勾选Use flutter format后会自动继承官方标准

用项目配置文件锁定规则 #

在项目根目录创建/完善analysis_options.yaml文件，明确指定格式化规则，让两款IDE统一读取这个配置：

include: package:flutter_lints/flutter.yaml

linter:
  rules:
    avoid_empty_else: true
    prefer_const_constructors: true

analyzer:
  language:
    strict-casts: true

# 格式化规则
dart_code_metrics:
  formatting:
    indentation: 2
    line_length: 80
    trailing_comma: always
    use_single_quotes: true

用Git钩子强制校验 #

在项目的.git/hooks目录下创建pre-commit脚本（无则新建），内容如下：

#!/bin/sh
# 检查所有暂存的.dart文件是否符合格式化规则
flutter format --set-exit-if-changed $(git diff --name-only --cached | grep '\.dart$')

# 格式化不通过则阻止提交
if [ $? -ne 0 ]; then
    echo "❌ 存在未格式化的Dart代码，请先执行flutter format修复后再提交"
    exit 1
fi

给脚本添加执行权限：chmod +x .git/hooks/pre-commit，这样任何人提交代码前都会自动校验，不符合规则的提交会被直接拦截。

统一Git换行符设置 #

换行符差异也会导致看似空格的冲突，团队统一配置：

• Windows用户执行：git config --global core.autocrlf true
• Mac/Linux用户执行：git config --global core.autocrlf input
• 项目根目录创建.gitattributes文件：

* text=auto
*.dart text eol=lf

确保所有Dart文件统一使用LF换行符，规避跨系统的换行符冲突。

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