VSCode团队协作配置需Git Hooks+编辑器行为+项目级配置三者联动，pre-commit必须显式调用lint-staged且仅处理暂存区文件，常见失效原因包括脚本错误、后缀遗漏、无package.json、Windows环境不兼容及VSCode设置冲突。
VSCode 团队协作配置无法靠单人设置“自动化”，必须结合 Git Hooks + 本地编辑器行为 + 项目级配置三者联动，否则成员各自为政，规则形同虚设。
pre-commit 钩子怎么触发 lint-staged 校验
关键不是“装了 Husky 就自动生效”，而是 pre-commit 脚本是否真正调用了 lint-staged，且只处理暂存区文件。常见失效场景包括：
- 运行
npx husky add .husky/pre-commit "npx lint-staged"后没检查生成的脚本内容，里面可能含多余空格或路径错误 -
lint-staged配置中匹配的文件后缀漏掉.tsx或.jsonc，导致新类型文件绕过校验 - 项目根目录没有
package.json，npx lint-staged找不到配置，静默失败（不报错但也不执行） - Windows 用户未启用 Git Bash 或 WSL，
#!/usr/bin/env sh头部导致钩子脚本无法执行
VSCode 保存时格式化和提交前校验冲突吗
不冲突，但顺序和职责必须分清：保存时用 prettier 快速美化，提交前用 eslint --fix + prettier --write 做终审。容易踩的坑有：
-
"editor.formatOnSave": true开启后，若"editor.defaultFormatter"指向esbenp.prettier-vscode，但项目没装prettier依赖，VSCode 会 fallback 到默认格式器，结果和lint-staged不一致 -
"editor.codeActionsOnSave": {"source.fixAll.eslint": true}和lint-staged都执行eslint --fix，可能重复修复、覆盖彼此改动（比如一个修了缩进，另一个又改回去了） - 团队成员 VSCode 设置里关掉了
formatOnSave，只依赖提交钩子——一旦某人git commit -m绕过编辑器，校验就彻底失效
提交模板怎么和 Conventional Commits 规则联动
VSCode 本身不解析提交类型，它只负责把模板内容填进输入框；真正校验 feat(api): 这种格式的是 commitlint。必须配齐三样：
- 模板文件（如
.gitmessage）里写明type(scope): subject结构，起引导作用 -
git config commit.template .gitmessage让 Git 加载模板（注意是项目级配置，不是全局） - 在
.husky/pre-commit后追加commit-msg钩子：npx husky add .husky/commit-msg "npx commitlint --edit $1"，并安装@commitlint/config-conventional和@commitlint/cli - 漏掉
commit-msg钩子，哪怕模板写得再规范，也能提交random text过去
最常被忽略的点：所有配置（.husky/、lint-staged.config.js、.commitlintrc.js、.vscode/settings.json）必须提交进仓库，并在 README 里写明“首次拉取后需运行 npm install”，否则新成员 clone 下来就是裸奔状态。
