代码格式化
Code Formatter
中级通用代码格式化（Code Formatter）是用工具按统一规则整理代码的缩进、换行和空格等写法。它解决多人或 AI 协作时同一份代码风格不一致的问题，让你更容易看清真正的修改。
你可能会说：「AI 写完页面后，代码缩进和换行乱七八糟，能不能自动整理成统一的样子？」
读之前建议先了解
动手看看订单金额函数的格式化
切换「执行格式化」对比原始写法和整理结果，再调整缩进与行宽。代码框可以用 Tab 聚焦；这里用参数模拟工具执行，不会运行代码。
工具统一了空格、缩进、换行和分号，但仍然是把商品价格相加。格式化整理的是写法，不是替你改业务逻辑。
开启格式化后，较窄的行宽会让函数调用拆成多行，参数再缩进一层。这是按语法断行，不是编辑器把长行视觉折叠。
底色标出主要整理区域，不代表逻辑修改。团队和 AI 都使用同一份格式配置，就能减少空格、换行造成的差异，更容易找到真正的代码变更。
要点代码格式化会改动什么？
- 1
整理写法而不是重写功能
格式化工具会按既定规则调整缩进、空格、换行等写法。例如你和 AI 分别改了后台页面，它能把两边的代码排成一致的样子；它的目标不是修改页面行为。
- 2
先确定规则再自动执行
同一段代码可以有不同的排版方式，所以团队通常会选定工具及其配置。这样你在编辑器里保存文件、同事在终端运行工具，得到的格式才容易保持一致。
- 3
把注意力留给真实改动
如果一次提交里混着大量缩进变化，你很难看出 AI 到底改了哪段逻辑。格式统一后，差异对比更聚焦；首次给旧项目批量格式化时，单独提交也更方便回看。
容易混淆的地方
代码格式化管的是代码怎么排版，不等于代码规范检查（Lint）：后者还可能指出未使用的变量等问题。它也不是重构；重构会调整代码结构，而格式化的目标是在不改变预期行为的前提下统一写法。具体哪些细节会被改动，取决于所用工具。
什么时候用
适合用
- 你和 AI Agent 轮流修改网站组件，提交前统一格式，让差异对比集中在实际改动上。
- 团队多人维护同一个后台项目，希望保存文件或提交代码时采用一致的排版规则。
- 接手一个排版不统一的项目，先选定格式化工具，再逐步整理需要继续维护的代码。
不适合用
- 登录接口返回错误结果，问题在业务逻辑或数据处理；先定位报错、补测试，而不是运行格式化工具。
- 产品页面的文字太密、层级不清，问题在界面排版；改布局和字距，代码格式化不会改变呈现效果。
- 你想检查变量是否误用或代码是否违反项目约定，应运行代码规范检查、类型检查或测试。
练一练选一个答案，看看解释
AI Agent 修改了订单页面，功能测试通过，但提交记录里出现大量仅由缩进和换行造成的差异。你接下来怎么处理更合适？
让 AI 帮你做复制给 AI Agent 直接用
请先查看这个项目是否已有代码格式化工具和配置，只按现有规则格式化你本次修改的文件，不改业务逻辑。完成后告诉我运行了什么命令，并检查差异对比，指出是否还有格式化以外的改动。