Prettier：确定性格式、幂等验证与团队基线

高谷深陵大约 6 分钟约 1717 字

Prettier 确定性格式闭环同一 parser、配置与版本把源码打印成稳定结果；check 裁决，write 只在受控入口改写。高清原图

Prettier 负责打印，不负责判断代码正确

Prettier 解析支持的语言，再以自己的 printer 生成确定性文本。它能消除缩进、换行、引号和尾逗号争论，却不证明变量已定义、CSS 属性有效或业务逻辑正确。JavaScript 语义进入 ESLint，样式规则进入 Stylelint；格式类规则只能有一个 owner。

本文实验锁定 Prettier 3.9.6。官方明确建议精确锁版本，因为小版本也可能改变输出；升级时以官方 Release和安装指南为准。版本号是实验基线，不是永久最新声明。

精确安装并验证本地解析

npm install --save-dev --save-exact prettier@3.9.6
npm ci
npm exec -- prettier --version
npm ls prettier

不要把未安装时的 npx prettier 当团队入口，它可能临时下载不同版本。编辑器也应优先加载项目依赖；在不可信工作区中，编辑器可能退回内置版本，因此 IDE 绿灯不能替代 CLI。

一个克制的 .prettierrc.json：

{
  "semi": true,
  "singleQuote": false,
  "trailingComma": "all"
}

Prettier 可以读取部分 .editorconfig，但项目 Prettier 配置优先。相同选项不要同时散落在个人 IDE、CLI 参数和多个嵌套配置中。CLI 决定检查还是写入，仓库配置决定输出。

配置查找必须能解释

Prettier 从目标文件目录向上寻找配置。Monorepo 中不同 package 可能命中不同文件，工作目录也会影响 ignore。用以下命令固定证据：

npm exec -- prettier --find-config-path packages/app/src/main.ts
npm exec -- prettier --file-info packages/app/src/main.ts
npm exec -- prettier packages/app/src/main.ts --check

--find-config-path 显示配置来源，--file-info 说明推断 parser 与 ignore 状态。文件未被格式化时先看这两个入口，不能先在编辑器里强制指定 parser。

.prettierignore 划出制品和第三方边界：

dist/
coverage/
generated/
vendor/
*.min.js

Prettier 也会参考同目录 .gitignore。ignore 变化必须在代码评审中展示匹配范围；排除整个源码目录会制造没有差异的假绿。

check 与 write 是两种权限

{
  "scripts": {
    "format:check": "prettier . --check",
    "format:write": "prettier . --write"
  }
}

--check 不改文件，以非零退出码告诉 CI 存在格式差异。--write 直接覆盖目标文件，只能在开发者明确调用、专门修复任务或独立机器人提交中运行。未经审查的 CI 不应在构建过程中修改源码后继续测试，否则测试对象已经不是提交内容。

先在临时文件制造差异：

const value={name:'demo',items:[1,2,3]}
console.log(value)

npm exec -- prettier .quality-smoke/prettier-bad.js --check 应非零。执行一次 --write 后转为通过；再执行第二次 --write，文件哈希应保持不变。这是幂等验证：同一版本、parser、配置与插件对自己的输出再次打印，不应继续产生 diff。

npm exec -- prettier .quality-smoke/prettier-bad.js --write
sha256sum .quality-smoke/prettier-bad.js
npm exec -- prettier .quality-smoke/prettier-bad.js --write
sha256sum .quality-smoke/prettier-bad.js

若第二次仍变化，检查插件加载顺序、嵌套配置、不同 CLI 版本或另一个保存修复器。不要用重复执行多次来“最终稳定”。

Prettier：确定性格式、幂等验证与团队基线

Prettier 负责打印，不负责判断代码正确

精确安装并验证本地解析

配置查找必须能解释

check 与 write 是两种权限

parser 与插件决定数据解释

与 Linter 的边界

大仓库与分阶段迁移

故障证据

升级与回滚