如何禁止提交已推送的user_data.json？Git与GitHub配置问题

DevOps 小满

2026-7-16

解决方案

一、允许本地编辑`user_data.json`但禁止推送至远程仓库

你之前添加.gitignore无效，是因为该文件已经被Git追踪（已提交到远程），.gitignore只对未被追踪的文件生效。可以通过以下两种思路实现需求：

让每个用户在自己的本地仓库执行Git命令，标记该文件为“无需追踪改动”，这样本地修改不会被提交和推送：

方法一：使用assume-unchanged
执行命令：
```
git update-index --assume-unchanged user_data.json
```
此命令会让Git认为该文件没有变化，git status不会显示它的修改，提交时也不会包含该文件。需要恢复追踪时，执行：
```
git update-index --no-assume-unchanged user_data.json
```
方法二：使用skip-worktree（更推荐）
执行命令：
```
git update-index --skip-worktree user_data.json
```
这个标记更适合“本地修改不推送”的场景，Git会完全忽略本地对该文件的修改，且拉取远程更新时不会覆盖本地改动（前提是远程仓库未修改该文件）。恢复命令：
```
git update-index --no-skip-worktree user_data.json
```

注意：以上操作都是本地设置，每个克隆仓库的用户都需要自行执行，无法通过远程仓库强制所有用户生效。

如果要从根源上禁止任何用户推送该文件的修改，可通过远程仓库的钩子或CI/CD实现：

自建Git服务器：配置pre-receive钩子，检查推送的提交内容，若包含user_data.json的修改则拒绝推送。示例脚本：
```
#!/bin/bash
while read oldrev newrev refname; do
  if git diff --name-only $oldrev $newrev | grep -q "^user_data.json$"; then
    echo "错误：禁止推送user_data.json的修改"
    exit 1
  fi
done
exit 0
```
将脚本保存为服务器仓库的.git/hooks/pre-receive，并赋予执行权限（chmod +x pre-receive）。
GitHub/GitLab等托管平台：通过CI/CD流程（如GitHub Actions）拦截。在推送触发的Workflow中，检查提交的文件列表，若包含user_data.json则标记任务失败，阻止修改合并到目标分支。

这个需求取决于你使用的远程仓库平台：

私有仓库：
- GitHub：将仓库设为私有，不给用户分配仓库访问权限，仅生成带有效期的ZIP下载链接分享（可在仓库页面点击"Download ZIP"复制临时链接，或通过个人AccessToken生成长期有效链接）。
- 自建服务器：关闭Git/SSH协议的克隆权限，仅开放HTTP/HTTPS的ZIP包下载，或通过服务器配置限制仅允许下载源码包，禁止git clone操作。
公开仓库：
公开仓库无法完全禁止克隆，因为Git协议是公开可访问的。此时只能将仓库设为私有，再通过上述方法分享ZIP包；或使用平台的Release功能发布ZIP格式的源码包，引导用户下载Release包而非克隆仓库。

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