JetBrains IDE 怎样配置项目级代码格式

团队协作时，代码格式最好跟着项目走，而不是跟着某一台电脑走。JetBrains IDE 的项目级代码格式方案可以把缩进、换行、导入排序等规则保存到项目目录，提交版本控制后，其他成员打开项目即可使用同一套设置。

官方地址：https://www.jetbrains.com/help/idea/configuring-code-style.html

关键做法是打开 Editor | Code Style，把 Scheme 选为 Project，再保存并共享项目生成的 .idea/codeStyles 目录。不要误选只保存在个人 IDE 配置目录里的 Default scheme。

先确认项目级方案解决什么问题

IntelliJ IDEA 文档把代码格式方案分成 Project scheme 和 Default scheme。Project scheme 只作用于当前项目，修改后会在项目下生成 .idea/codeStyles；Default scheme 属于 IDE 级别，可能影响多个项目，但不会随当前项目通过版本控制共享。

因此，团队约定、项目格式和代码评审规则应优先放在 Project scheme。本文以 IntelliJ IDEA 的设置路径为例，其他 JetBrains IDE 可能有相近的菜单结构，但最终应以当前 IDE 的 Code Style 页面为准。

打开项目级代码格式设置

1. 打开目标项目，进入 File → Settings → Editor → Code Style；macOS 通常从 IDE 名称 → Settings 进入。也可以使用快捷键 Ctrl+Alt+S 打开设置。
2. 在 Code Style 页面选择实际使用的语言，例如 Java、Kotlin、Go 或 XML。代码格式是按语言分别配置的，不能只改一个语言就期待所有文件一起变化。
3. 在 Scheme 下拉框选择 Project。如果当前是 Default 或其他 IDE-level scheme，先切换到 Project，再修改规则。

进入正确方案后，再按项目约定修改 Tabs and Indents、Wrapping and Braces、Imports 等页面。右侧预览区会反映部分设置的变化，它适合确认当前语言和当前方案是否选对，但不代替团队对规则的约定。

调整规则并留下可复查的状态

1. 先改最容易产生差异的规则，例如缩进大小、使用空格还是制表符、连续空行和长行换行方式。
2. 再检查导入排序、星号导入阈值和代码折行等项目规则。每改一组规则，都观察预览区是否出现对应变化。
3. 如果需要从已有方案开始，可以使用 Scheme Actions 的 Duplicate 创建副本；这样既保留原方案，也方便把新方案命名为项目约定名称。

项目级方案只有一个 Project scheme。需要同时保留多套个人方案时，可以把副本留在 IDE-level；但项目真正要共享的那套规则，仍应回到 Project scheme，避免成员各自选择了不同的个人方案。

保存并共享 .idea/codeStyles

1. 点击 Apply 或 OK 保存设置，然后回到项目文件树查看是否出现 .idea/codeStyles。
2. 在版本控制工具中确认该目录下的代码格式 XML 被识别为项目改动。将它提交到项目仓库前，先排除个人窗口布局、最近文件等与格式无关的 IDE 文件。
3. 如果要把方案迁移到另一个项目，可在 Scheme Actions 中使用 Export；官方文档也列出了 Project scheme 与 IDE-level scheme 之间的复制方向。导入后仍要检查当前语言和当前 Scheme 是否正确。

验收的重点不是只看到设置窗口关闭，而是确认项目里确实有 .idea/codeStyles，并且版本控制能看到对应文件。这样换一台电脑或让同事重新拉取项目后，Project scheme 才有机会保持一致。

换一份项目副本做最终核对

提交后可以用另一份工作副本做一次轻量核对：重新打开项目，回到 Editor → Code Style，确认 Scheme 仍显示 Project；打开一个会触发格式化的文件，检查缩进、换行或导入顺序是否符合约定。这个过程只验证设置是否被项目加载，不需要把个人 Default scheme 一并提交。

常见问题

Project scheme 和 Default scheme 有什么区别？

Project scheme 只服务当前项目，规则可保存在项目的 .idea/codeStyles 中共享；Default scheme 属于 IDE 层面，适合个人默认偏好，不适合作为团队唯一约定。

必须把整个 .idea 目录都提交吗？

不必。本文关注的是代码格式共享，应按团队的版本控制策略只提交与格式相关的 .idea/codeStyles 文件，其他个人化 IDE 文件继续遵循项目的忽略规则。

小结

配置项目级代码格式可以归纳为四步：进入 Editor | Code Style，选择 Project，按语言调整并保存，再确认 .idea/codeStyles 已纳入共享。真正的验收点是另一份项目副本仍加载 Project scheme，并在格式化时得到同样的结果。