做Python开发离不开代码管理，而Git是目前最主流的版本控制工具。很多初学者在写完脚本后常常面临文件丢失、无法回溯修改或者团队协作混乱的问题。掌握Git不仅能帮你安全保存每一次代码迭代，还能大幅提升项目交付的效率。下面这份教程将带你从零开始，把Git无缝融入Python日常开发流程，避开常见陷阱，建立规范的工作习惯。
一、安装Git并配置身份信息
打开命令行终端，输入git version检查是否已安装。如果没有，去官网下载对应系统的安装包即可。安装完成后，需要设置全局用户名和邮箱，这会在每次提交时生成作者标识。执行git config --global user.name你的名字和git config --global user.email你的邮箱地址。建议关闭自动行尾转换，避免跨平台换行符冲突，运行git config --global core.autocrlf input。这些基础配置只需做一次，后续项目都能继承。
二、初始化本地仓库与常用命令
进入你的Python项目文件夹，在终端输入git init创建本地仓库。此时目录里会多出一个隐藏文件夹，专门存放版本记录。接着用git status查看当前状态，未跟踪的文件会显示为绿色提示。准备上传前，先用git add把文件加入暂存区。如果想一次性添加所有改动，可以直接运行git add .。确认无误后，使用git commit -m简短描述提交的内容，比如添加了数据清洗函数。记住，每次功能完善或修复Bug都应当有一次独立的提交记录，方便日后回滚。
三、Python项目的特殊处理技巧
Python开发中有很多不需要上传到远程仓库的文件，比如虚拟环境文件夹、缓存字节码以及本地配置文件。如果不加过滤直接提交，不仅占用空间还会引发冲突。在项目根目录新建.gitignore文件，在里面写入venv/、__pycache__/、*.pyc以及.env等常见忽略规则。这样Git会自动跳过这些文件，只追踪核心源代码。对于依赖管理，推荐使用requirements.txt导出库列表，配合pip install -r requirements.txt让新成员一键还原环境，保持项目一致性。
四、连接远程仓库与协作流程
个人练习可以只留在本地，但正式项目通常需要推送到GitHub或Gitee等平台。先在远程平台创建空仓库，获取HTTPS或SSH链接。回到终端执行git remote add origin链接地址，将远程仓库绑定到本地origin别名。第一次推送时使用git push -u origin master，后续只需git push即可。多人协作时，务必养成先拉取再提交的习惯。运行git pull先把他人更新同步到本地，解决可能的冲突后再提交，避免覆盖同事的代码。遇到合并冲突时，编辑器会明确标出差异部分，手动保留正确逻辑后重新提交。
五、日常维护与避坑建议
保持提交频率高且粒度细是最佳实践。不要等到写完几千行代码才一次性提交，拆分功能点记录日志能让排查问题快得多。定期清理无用分支，使用git branch删除本地旧分支，保持仓库整洁。如果误删了重要文件，可以用git checkout --文件名快速恢复工作区内容。遇到复杂错误别慌，git reflog能找回所有历史操作指针，几乎不会真正丢失数据。熟悉这几个核心动作后，Python项目的版本管理就会变得非常顺手，开发效率也会稳步提升。
