VSCode如何配置lint-staged暂存检查_VSCode lint-staged暂存检查配置策略-VSCode-PHP中文网

lint-staged 不自动触发是因 Git pre-commit 钩子未正确安装；需确认 husky 是否初始化、.git/hooks/pre-commit 是否存在且可执行，并确保文件匹配路径以项目根为基准、glob 使用正斜杠、避免 VSCode 与 lint-staged 重复格式化。

vscode如何配置lint-staged暂存检查_vscode lint-staged暂存检查配置策略

lint-staged 在 VSCode 里不自动触发？检查 pre-commit 钩子是否真在运行

VSCode 本身不执行 lint-staged，它只负责调用 Git 命令；真正触发检查的是 Git 的 pre-commit 钩子。如果你点 VSCode 右下角“提交”按钮没反应，或终端里 git commit 也没跑检查，大概率是钩子根本没装上。

运行 npx lint-staged --version 确认已安装（通常随 husky 或 simple-git-hooks 引入）
检查 .git/hooks/pre-commit 文件是否存在且可执行（不是空文件、不是 Windows 的 .cmd 后缀残留）
如果用 husky@8+，确保已执行过 npx husky install，且 package.json 里有 "prepare": "husky install" 并运行过 npm run prepare
VSCode 默认走系统 shell 提交，但某些终端配置（如 zsh 插件覆盖 PATH）可能导致找不到 npx，可在 VSCode 设置里加 "git.terminalAuthentication": false 强制走 GUI 提交流程（需配合 husky 正常工作）

配置 lint-staged 规则时文件匹配不到？注意 glob 模式作用域和路径基准

lint-staged 匹配的是 Git 暂存区中的相对路径（以项目根为基准），不是你当前编辑器打开的文件路径，也不是 src/ 子目录下的相对路径。常见现象：改了 src/utils/index.ts，但 "src/**/*.{ts,tsx}" 没生效。

所有 glob 必须写成相对于项目根的路径，例如 "**/*.{js,jsx,ts,tsx}"，而不是 "src/**/*"（除非你明确只想处理 src 下的暂存文件）
Windows 用户要注意反斜杠问题："src\**\*.ts" 是错的，统一用正斜杠 "src/**/*.ts"
若使用 eslint + prettier 组合，别把 prettier --write 放在 eslint --fix 前面——eslint 可能会覆盖 prettier 格式化结果，建议顺序为 eslint --fix → prettier --write

示例正确配置片段：

"lint-staged": {
  "**/*.{js,jsx,ts,tsx}": ["eslint --fix", "prettier --write"],
  "**/*.{json,md,yml}": ["prettier --write"]
}

VSCode 保存时就格式化，但提交又跑一遍？避免重复操作和冲突

VSCode 的 editor.formatOnSave 和 lint-staged 都调 prettier，容易造成两次格式化、甚至因 ESLint 自动修复插入分号而与 Prettier 冲突。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

推荐关闭 VSCode 的自动保存格式化（设 "editor.formatOnSave": false），把格式化权完全交给 lint-staged —— 它只处理你真正要提交的文件，更精准
如果坚持保留保存时格式化，请确保 VSCode 使用的 formatter（如 esbenp.prettier-vscode）配置与 lint-staged 中一致，尤其是 prettier.printWidth、semi、singleQuote 等关键项
检查 .prettierrc 和 .eslintrc.cjs 是否存在规则冲突，比如 eslint-config-prettier 没关掉 semi 规则，而 prettier 设了 semi: false，就会在提交时反复增删分号

修改后 git add . 但 lint-staged 没跑？确认暂存文件类型和 hook 执行时机

lint-staged 只对「已加入暂存区」的文件运行，且只在 git commit 这一刻触发。常见误操作：改完代码直接点 VSCode 提交按钮，但忘了先 git add。

VSCode 提交面板默认只提交已暂存文件（Staged Changes），如果右侧面板里没看到文件，说明还没 git add，此时点击提交不会触发 lint-staged
检查 lint-staged 配置中是否漏写了目标后缀，比如改了 .vue 文件，但配置里只有 "*.js"，自然跳过
某些 IDE 插件（如 GitLens）可能绕过标准 Git CLI，导致钩子失效；遇到异常可尝试在终端手动运行 git add . && git commit -m "test" 验证基础流程
Mac 上如果用 zsh，偶尔会因 shell 函数覆盖 npx 导致钩子报 command not found: npx，可在 .husky/pre-commit 开头加 #!/usr/bin/env bash 并显式指定 /opt/homebrew/bin/npx（或你的实际路径）

最常被忽略的一点：lint-staged 不处理未被 Git 跟踪的新文件（untracked files），哪怕你 git add -N 告诉 Git “我知道这文件”，它也不会进 lint 流程——必须先 git add 再 git commit，且文件已在 .gitignore 之外。