如何使Bitbucket仓库配置文件忽略本地修改并禁止误提交？

哈哈，这个坑我简直太熟悉了！本地改完配置随手提交推送，结果把生产配置搞乱，事后半天擦屁股的痛苦谁懂😂 给你几个从本地到仓库端的解决方案，覆盖不同场景，你按需选：

你提到的git update-index --assume-unchanged其实更适合那些真的不会被修改的文件，而咱们这种“本地改了但绝对不想提交”的场景，用--skip-worktree才是更靠谱的选择——它会告诉Git：“这个文件我本地改我的，你别管也别把它加到提交里”。

操作步骤超简单：

• 标记不想提交的配置文件：

  git update-index --skip-worktree <你的配置文件路径>
  

  比如你的文件是config/prod.env，就写git update-index --skip-worktree config/prod.env
• 要是之后需要拉取仓库里该文件的更新，先取消标记：

  git update-index --no-skip-worktree <你的配置文件路径>
  

• 查看当前所有被标记的文件：

  git ls-files -v | grep "^S"
  

  输出里开头是S的就是被skip-worktree标记的文件

上面的方法是“堵”，而分离配置是“疏”，从根源上避免本地和生产配置混在一起的问题，适合团队协作场景：

• 先把仓库里的生产配置文件改成模板：比如把config.yml重命名为config.prod.yml.template，提交并推送到仓库：

  git mv config.yml config.prod.yml.template
  git add .
  git commit -m "rename prod config to template"
  git push
  

• 本地复制模板生成自己的配置文件：

  cp config.prod.yml.template config.local.yml
  

• 修改项目的配置加载逻辑：让项目优先读取本地的config.local.yml，如果这个文件不存在，再用模板里的生产配置（或者直接加载生产环境的配置）
• 把config.local.yml加入.gitignore，提交这个修改，这样本地配置永远不会被Git追踪：

  echo "config.local.yml" >> .gitignore
  git add .gitignore
  git commit -m "ignore local config file"
  git push
  

如果怕本地标记失效，或者团队里其他人也容易犯同样的错，可以在Bitbucket仓库端加一层防护：

• 预接收钩子（Pre-receive Hook）：在Bitbucket仓库的「设置」→「仓库钩子」里添加预接收钩子，写个简单的脚本检查推送内容——如果有人推送了指定配置文件的修改，直接拒绝推送。比如脚本核心逻辑：

  # 检查推送的文件中是否包含禁止修改的配置文件
  while read oldrev newrev refname; do
    for file in $(git diff --name-only $oldrev $newrev); do
      if [ "$file" = "config/prod.env" ]; then
        echo "Error: 修改生产配置文件 $file 是不允许的！"
        exit 1
      fi
    done
  done
  

• Bitbucket分支保护规则：对生产分支（比如main或master）设置分支保护，开启「禁止直接推送」，要求所有修改必须通过PR合并；同时可以在PR设置里添加路径限制，禁止合并修改指定配置文件的PR。

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