Git：如何阻止包含debugger关键字的JS代码提交？

当然可行啦！在多人协作的JS项目里，避免把调试用的debugger不小心提交到仓库是非常实用的需求，我们可以借助Git的钩子机制轻松实现这个功能，下面给你拆解具体的实现思路和步骤：

核心实现方向：Git 预提交钩子（pre-commit） #

Git 的pre-commit钩子是在提交操作真正执行前触发的脚本，我们可以在这里编写检查逻辑——一旦检测到暂存的JS文件里包含debugger关键字，就直接终止提交流程。

步骤1：手动编写pre-commit钩子脚本 #

• 先进入项目的.git/hooks目录（这个目录默认有一些示例钩子文件，比如pre-commit.sample，可以参考它的格式）
• 创建一个没有后缀的pre-commit文件，写入以下bash脚本：

#!/bin/sh

# 筛选出所有暂存的.js文件，逐个检查是否包含debugger
git diff --cached --name-only | grep -E '\.js$' | while read file; do
  if grep -q 'debugger' "$file"; then
    echo "❌ 提交失败：文件 $file 中存在debugger关键字，请移除后再提交！"
    exit 1
  fi
done

# 没有问题就放行提交
exit 0

• 最后给这个脚本添加执行权限：在终端运行chmod +x .git/hooks/pre-commit

步骤2：让钩子在团队中同步生效 #

上面的钩子只存在于本地的.git/hooks目录，而这个目录不会被Git追踪，所以要让团队所有人都用上这个钩子，可以选下面两种方式：

• 方式一：手动共享钩子模板
  在项目根目录创建一个专门的hooks文件夹，把写好的pre-commit放进去，然后在项目的README里说明操作步骤，让团队成员执行cp hooks/pre-commit .git/hooks/ && chmod +x .git/hooks/pre-commit来安装。
• 方式二：用npm工具自动管理
  如果项目用npm管理依赖，推荐用husky这类工具来统一管理Git钩子，配置更简单还能自动同步给团队：
  1. 安装husky：npm install husky --save-dev
  2. 在package.json里添加prepare脚本，确保团队成员安装依赖后自动初始化husky：

     {
       "scripts": {
         "prepare": "husky install"
       }
     }
     

  3. 执行npm run prepare完成husky初始化
  4. 创建pre-commit钩子：npx husky add .husky/pre-commit "npm run check-debugger"
  5. 在package.json里添加检查脚本：

     {
       "scripts": {
         "check-debugger": "git diff --cached --name-only | grep -E '\.js$' | xargs grep -l 'debugger' || exit 0"
       }
     }
     

     这个脚本的逻辑是：如果找到含debugger的文件，grep会返回非0状态，husky就会终止提交；如果没找到，就正常继续提交流程。

额外优化：结合ESLint双重保障 #

如果项目已经在用ESLint，可以直接在ESLint规则里添加禁止debugger的配置，这样在开发阶段就能实时收到提示，配合Git钩子形成双重保障：

• 在你的ESLint配置文件（比如.eslintrc.js）中添加规则：

module.exports = {
  // ...其他配置
  rules: {
    'no-debugger': 'error'
  }
};

之后可以把pre-commit钩子的检查换成执行ESLint，比如npx eslint . --quiet，这样既能检查debugger，也能顺带检查其他代码规范问题。

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