最新Ionic项目TSLint问题：提交前校验失败仍提交及hooks团队共享

1. 检查并修正package.json配置 #

首先确保你的package.json里的脚本和husky配置正确，旧版husky（v0.15.x）的配置方式如下：

{
  "devDependencies": {
    "husky": "^0.15.0-rc.6",
    // 确保你的lint工具依赖已安装，比如eslint、@ionic/eslint-config等
    "eslint": "^xxx",
    "@ionic/eslint-config": "^xxx"
  },
  "scripts": {
    "lint": "ionic lint" // 或者你的具体lint命令，比如"eslint src/**/*.ts"
  },
  "husky": {
    "hooks": {
      "pre-commit": "npm run lint"
    }
  }
}

关键注意点：

• 确保npm run lint在检测到错误时返回非零退出码：执行有错误的代码后，运行npm run lint，然后在终端执行：
  • Linux/macOS：echo $?，如果输出1或非零值，说明正常；如果是0，则需要检查lint命令的配置（比如是否加了--fix自动修复、或者lint规则是否没有正确标记错误）。
  • Windows：echo %errorlevel%，同样需要返回非零值。

2. 重置并重新安装husky钩子 #

由于你之前重置过Git hooks，可能存在钩子文件异常，按以下步骤操作：

1. 先删除旧的pre-commit钩子文件：

   rm .git/hooks/pre-commit
   

2. 重新触发husky的钩子安装：

   npm install
   

   旧版husky会在npm install时自动将配置的钩子写入.git/hooks目录。
3. 验证钩子文件：打开.git/hooks/pre-commit，确认内容包含执行npm run lint的逻辑（husky生成的脚本会调用你的pre-commit命令）。

3. 测试钩子是否生效 #

1. 在代码里故意写一个违反lint规则的内容（比如未使用的变量、不符合格式的代码）。
2. 暂存代码：git add .
3. 尝试提交：git commit -m "Test lint hook"
   • 如果lint检测到错误，终端会输出错误信息，并且Git会终止提交，说明钩子生效；
   • 如果仍然提交成功，再检查npm run lint的退出码是否正确，或者钩子文件是否被其他工具（比如precommit包）覆盖。

4. 同步钩子给团队成员 #

由于.git/hooks目录不会被Git追踪，要让团队成员自动获取钩子，只需做到以下几点：

• 确保husky和所有lint相关依赖都在package.json的devDependencies里，这样团队成员执行npm install时会自动安装。
• 团队成员clone项目后，执行npm install，husky会自动在他们的本地.git/hooks目录生成pre-commit钩子，无需额外操作。
• 可以在项目的README里添加说明：安装依赖后，pre-commit钩子会自动生效，提交前会自动执行lint校验。

额外排查点 #

如果你同时安装了precommit包，可能和husky产生冲突，建议只保留husky作为钩子管理工具，卸载precommit：

npm uninstall precommit --save-dev

然后重新执行npm install，确保钩子由husky单独管理。

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