虽然git用了很长时间,但是距离精通还是太远了。注意到虚拟环境是因为上传项目时用到的系统是macOS,而拉取项目时用到的系统是win,意识到是时候学习知识了(好懒啊)。
头一次上传:使用.gitignore避免虚拟环境被上传
然后将 .venv
添加到 .gitignore(在
项目根目录创建)
,确保 Git 以后不会再追踪它。
echo ".venv/" >> .gitignore
git add .gitignore
git commit -m "Ignore virtual environment"
同样,.gitignore还可以写不能上传到git的大文件的路径
如果你之前commit过,之后可以直接git push origin branch_name
已上传虚拟环境的项目更改成不再上传虚拟环境
对于已上传虚拟环境的项目,即使上传了.gitignore,还是有可能被追踪.venv(虚拟环境)
执行以下命令,让 Git 忽略已经被跟踪的 .venv
目录:
git rm -r --cached .venv
解释:
--cached
选项表示 只从 Git 索引中移除,不会删除本地文件。
如果 .venv
仍然存在于历史提交中
即使 .gitignore
和 git rm -r --cached .venv
生效,你的 .venv
可能已经在之前的提交历史中,这会导致 GitHub 仍然检测到大文件。
如果你想 彻底删除 .venv
相关的历史记录,可以使用 git filter-branch
或 BFG Repo-Cleaner
:
git filter-branch --force --index-filter 'git rm -r --cached --ignore-unmatch .venv' --prune-empty --tag-name-filter cat -- --all
详细解析
1. git filter-branch
git filter-branch
是一个强大的 Git 命令,它允许你在 整个 Git 历史 上进行修改,比如重写提交、删除文件等。
2. --force
强制执行 git filter-branch
,即使 Git 之前警告这个命令已经被弃用(推荐使用 git filter-repo
)。
3. --index-filter 'git rm -r --cached --ignore-unmatch .venv'
这个部分是核心,它告诉 Git 在 所有提交历史 中执行 git rm -r --cached .venv
,即:
git rm -r --cached .venv
:递归地从索引(暂存区)中删除.venv
,但不会影响本地文件。--ignore-unmatch
:如果.venv
文件不存在,不会报错。
⚠️ 这个操作不会影响 本地的 .venv
文件,但它会让 Git 认为 .venv
从未存在过。
4. --prune-empty
如果某个提交 只包含 .venv
(即 .venv
是唯一的修改),那么删除 .venv
后,这个提交就变成空提交。--prune-empty
选项可以 删除这些空提交,保持 Git 历史的整洁。
5. --tag-name-filter cat
这个选项确保 Git 的 tag(标签)不会受到影响,仍然保留 tag 信息。
6. -- --all
--all
作用是:
- 让这个操作应用到 所有分支(不仅仅是当前分支)。
--
这个符号用于告诉 Git,后面的是文件路径或分支名,避免混淆。
更现代的替代方法
⚠️ Git 官方不推荐 git filter-branch
,建议使用 git filter-repo
。
至此,再次推送就可以了