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 不会替你做这件事。
