VS Code保存时与CLI执行Prettier输出不一致问题排查

我正在排查不同调用方式下Prettier输出存在差异的原因，目前配置了三种Prettier调用方式：

• VS Code配置在保存时自动运行
• 通过husky在代码提交时运行
• 通过npm脚本（pnpm prettier）对所有文件执行

问题是prettier-plugin-sort-imports插件仅在VS Code保存文件时生效，通过husky或npm脚本执行时完全不生效，求解决思路。

配置信息 #

1. VS Code保存执行Prettier配置（User\settings.json） #

"editor.formatOnSave": true,
...
  "[*]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },

2. Prettier + lint-staged（husky提交时执行）配置（package.json） #

"scripts": {
...
    "prettier": "npx prettier --write .",
...
  },
...
  "prettier": {
    "semi": false,
    "printWidth": 100,
    "sortingMethod": "alphabetical",
    "importTypeOrder": [
      "localImports",
      "NPMPackages"
    ],
    "plugins": [
      "./node_modules/prettier-plugin-sort-imports/dist/index.js"
    ]
  },
...
  "lint-staged": {
    "*": [
      "eslint --fix",
      "prettier --write"
    ]
  },
...
  "devDependencies": {
...
    "prettier": "^3.1.1",
    "prettier-plugin-prisma": "^5.0.0",
    "prettier-plugin-sort-imports": "^1.8.1",

3. husky提交钩子配置 #

#!/bin/sh
. "$(dirname "$0")/_/husky.sh"

npx lint-staged

解决思路 #

1. 优先排查版本兼容性问题 #

Prettier 3.x对插件API做了重大改动，你用的prettier-plugin-sort-imports@1.8.1是旧版本，大概率不兼容Prettier 3.x。

• 方案一：降级Prettier到2.x（比如prettier@2.8.8），旧插件适配2.x没问题
• 方案二：换成适配Prettier 3.x的导入排序插件，比如@trivago/prettier-plugin-sort-imports（带@trivago前缀的这个维护更活跃，已支持3.x）

2. 修正插件路径配置 #

package.json里的插件用了本地相对路径，在pnpm或npx调用时可能出现路径解析问题，直接用包名配置更稳妥：

"plugins": ["prettier-plugin-sort-imports"]

3. 调整lint-staged执行顺序 #

你现在是先跑eslint --fix再跑prettier --write，如果ESLint启用了自己的导入排序规则（比如eslint-plugin-import的order规则），会覆盖Prettier插件的排序结果。

• 把顺序反过来：先执行prettier --write，再执行eslint --fix
• 或者直接关掉ESLint里的导入排序规则，让Prettier统一处理

4. 修正pnpm环境下的调用方式 #

pnpm的依赖隔离机制可能导致npx找不到项目内的Prettier和插件，把npm脚本里的调用改成pnpm exec：

"scripts": {
  "prettier": "pnpm exec prettier --write ."
}

这样能确保调用的是项目本地安装的Prettier，而不是全局的。

5. 验证插件是否被加载 #

执行以下命令查看Prettier是否成功加载了插件：

pnpm prettier --debug-check .

如果输出里没有提到prettier-plugin-sort-imports，说明插件没被加载，回到前面的步骤排查路径或兼容性问题。

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