如何在WebStorm中配置Husky和Lint-staged钩子？

husky 和 lint-staged 是 Node.js 环境下的 Git hooks 工具，非 WebStorm 内置功能；WebStorm 仅调用 Git 命令，实际钩子由 Git + husky 触发，需项目正确安装 husky、生成 .husky/ 目录，并确保 lint-staged 配置匹配文件类型与工具链。

先把结论摆在这儿：husky 和 lint-staged 从来就不是 WebStorm 的“亲儿子”，它们运行在 Node.js 环境里。WebStorm 只负责调用 Git 命令（比如 git commit），而真正的钩子触发，是 Git 和 husky 之间的事。所以，配置的根不在 IDE 的设置面板里，而在项目工程本身。

实际上，WebStorm 会自动识别并执行已安装的 husky 钩子——但前提是，项目本身已经正确初始化了 husky，并且 .git/hooks 目录下确实存在对应的脚本。这一点，是很多问题的起点。

确认 husky 是否真正生效

很多问题其实卡在这一步：看起来装了，但 git commit 时没反应。理由不外乎这几个：

• husky install 没运行，或者运行失败了（比方说，项目压根没执行 git init）
• Node 版本太新或太旧，导致 husky 安装时跳过了钩子注册——终端里会看到一行 Skipping Git hooks installation
• package.json 里没有配置 "prepare": "husky install"，或者手动运行了 npx husky install 却没生成 .husky/ 目录
• WebStorm 使用了内置 Git，而这个内置 Git 没加载系统环境变量（尤其是 PATH 里的 Node/npm）——解决方法是进入 Settings > Version Control > Git > Path to Git executable，把路径改成绝对路径，比如 /usr/local/bin/git 或 C:\Program Files\Git\bin\git.exe

lint-staged 配置必须匹配文件扩展名和工具链

举个例子，如果你的 lint-staged 配置里只写了 "*.js"，但项目用的是 TypeScript，那 .ts 文件根本就不会被处理。同理，prettier --write 对 .vue 文件默认不生效，除非你装了 prettier-plugin-vue 并在 .prettierrc 中明确启用。

这里有几个典型的易错点：

• 忘记在 lint-staged 配置里包含 .ts、.tsx、.vue 这些实际用到的文件扩展名
• 用了 eslint --fix，但项目没装 eslint-config-prettier，导致规则冲突——--fix 一旦失败，整个 pre-commit 流程就会中断
• 升级到 lint-staged v15+ 后，还在配置里保留 "git add" 命令——v10 版本起已经自动暂存修改了，再加这条命令反而会报 warning 或导致重复添加
• lint-staged 脚本返回了非零退出码（比如 ESLint 报了 error 且没配 --quiet），提交被拦住，但 WebStorm 的 Commit 对话框里只显示 “Commit failed”，不告诉你具体错在哪

在 WebStorm 提交时看到错误，怎么快速定位？

WebStorm 的 Git 提交窗口有个小毛病：它默认隐藏了命令行输出。要看到真实日志，你得手动触发一次终端提交：

• 打开 WebStorm 终端（Alt+F12），执行 git commit -m "test"
• 如果失败，完整错误会打印出来——比如 Cannot find module 'prettier'（说明本地没装 prettier，或者没用 --sa ve-dev），或者 ESLint couldn't find the config "prettier"
• 检查 node_modules/.bin/ 目录下是否存在对应的二进制文件：ls node_modules/.bin | grep -E "(prettier|eslint|lint-staged)"
• 确认当前终端的工作目录就是项目根目录（不是子包目录），否则 package.json 里的配置不会生效

最容易被忽略的一点：husky 的钩子依赖于 .git 目录下的可执行脚本，而这些脚本是由 npx husky install 生成的。一旦你删了 .husky 目录，或者重装了 node_modules，就必须重新运行它——WebStorm 不会替你做这件事。