如何配置Git防止直接编辑或提交至main分支？

方法一：本地仓库钩子（仅当前项目生效） #

这是最直接的方式，通过Git的pre-commit钩子在提交前检查当前分支，一旦检测到是main分支就直接终止提交：

• 打开终端，进入项目根目录，执行命令进入钩子目录：

  cd .git/hooks
  

• 创建并编辑pre-commit文件（用vim或你习惯的编辑器均可）：

  vim pre-commit
  

• 粘贴以下脚本内容，保存退出：

  #!/bin/bash
  CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
  if [ "$CURRENT_BRANCH" = "main" ]; then
      echo "❌ 禁止直接在main分支提交，请切换到开发分支操作！"
      exit 1
  fi
  

• 给这个文件添加可执行权限：

  chmod +x pre-commit
  

之后只要你在main分支执行git commit，就会弹出提示并直接终止提交操作。

方法二：全局钩子模板（所有Git项目生效） #

如果想让所有本地Git项目都应用这个限制，可以配置全局钩子模板：

• 先在本地创建存放全局钩子的目录：

  mkdir -p ~/.git-templates/hooks
  

• 把刚才的pre-commit文件复制到这个目录，同样添加可执行权限：

  cp .git/hooks/pre-commit ~/.git-templates/hooks/
  chmod +x ~/.git-templates/hooks/pre-commit
  

• 配置Git使用这个全局模板：

  git config --global init.templatedir '~/.git-templates'
  

注意：这个配置仅对之后初始化或克隆的项目生效，已存在的项目需要重新执行git init（不会影响现有代码）来应用模板。

额外提示：提前阻止误切到main分支编辑 #

如果想连切换到main分支的操作都提前预警，可以添加post-checkout钩子，切换到main分支时自动弹出警告：

• 在钩子目录创建post-checkout文件，粘贴以下内容：

  #!/bin/bash
  CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
  if [ "$CURRENT_BRANCH" = "main" ]; then
      echo "⚠️ 注意：当前处于main分支，请勿直接编辑或提交！"
  fi
  

• 给文件添加可执行权限：

  chmod +x post-checkout
  

这样每次切换到main分支都会收到提示，提前避免误操作。

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