一、Git 基础：为什么选择 Git？
Git 是分布式版本控制系统的标杆，由 Linux 之父 Linus Torvalds 开发。与 SVN 等集中式版本控制系统相比，它具有以下核心优势：
- 分布式架构：每个开发者本地都有完整代码仓库，离线也能提交
- 高效分支管理：秒级创建 / 合并分支，支持并行开发
- 强大的历史追踪：精确记录每一次代码变更，支持任意版本回溯
- 丰富的协作模式：完美支持单人开发、团队协作和开源项目
二、环境准备：安装与配置
1. 安装 Git
Windows 系统
- 官网下载安装包：Git for Windows
- 安装时建议勾选 "Use Git from the Windows Command Prompt"
macOS 系统
- 终端执行：
brew install git - 或通过官网安装包安装：Git for Mac
Linux 系统
- Debian/Ubuntu 系：
sudo apt-get install git - RedHat/CentOS 系：
sudo yum install git
2. 基础配置
首次使用需配置用户信息：
bash
git config --global user.name "你的姓名"
git config --global user.email "你的邮箱地址"
查看配置：
bash
git config --list
三、核心操作：从本地仓库开始
1. 初始化仓库
bash
# 在项目目录执行
git init
此时会生成隐藏的.git目录，用于存储版本控制数据。
2. 文件操作三步骤
（1）添加文件到暂存区
bash
# 添加单个文件
git add 文件名.txt
# 添加所有文件
git add .
# 撤销暂存区文件
git reset HEAD 文件名.txt
（2）提交到本地仓库
bash
git commit -m "清晰的提交说明" # 建议使用英文或规范中文
最佳实践：单个提交应包含独立功能，提交说明遵循动词+名词结构（如 "Fix login bug"）
（3）查看提交历史
bash
git log # 完整日志
git log --oneline # 简洁模式
git log -p # 查看每次提交的差异
3. 版本回退
bash
# 查看所有版本ID
git reflog
# 回退到指定版本（保留本地修改）
git reset --soft 版本ID
# 回退并撤销暂存区和工作区修改
git reset --hard 版本ID
四、分支管理：并行开发的核心
1. 基础分支操作
bash
# 查看分支（当前分支标*）
git branch
# 创建新分支
git branch 新分支名
# 切换分支
git checkout 分支名
# 新建并切换分支（快捷命令）
git checkout -b 新分支名
2. 分支合并与冲突解决
（1）合并分支到当前分支
bash
git merge 目标分支名
（2）解决冲突
当合并出现冲突时：
- 编辑器会打开冲突文件，显示冲突区域：
plaintext
<<<<<<< HEAD 主分支内容 ======= 待合并分支内容 >>>>>>> 分支名 - 手动修改为正确内容，删除冲突标记
- 重新添加并提交：
bash
git add 冲突文件 git commit -m "解决分支合并冲突"
3. 分支清理
bash
# 删除本地分支（需先切换到其他分支）
git branch -d 分支名
# 强制删除未合并分支
git branch -D 分支名
五、远程协作：连接 GitHub/GitLab
1. 关联远程仓库
bash
# 添加远程仓库（默认名称origin）
git remote add origin 远程仓库URL
# 查看远程仓库
git remote -v
2. 代码推拉
（1）获取远程代码
bash
# 克隆仓库（首次使用）
git clone 仓库URL
# 拉取更新并合并到当前分支
git pull origin 分支名
# 拉取更新并创建新的合并提交
git pull --rebase origin 分支名
（2）推送代码
bash
# 首次推送需指定远程分支
git push -u origin 本地分支名
# 后续推送
git push
# 强制推送（谨慎使用）
git push --force
3. 协作开发最佳实践
- 采用
主分支(main/master)+特性分支模式 - 提交前使用
git pull --rebase保持代码整洁 - 通过 Pull Request 进行代码审查
- 重要版本打标签：
bash
git tag v1.0.0 # 轻量级标签 git tag -a v1.0.1 -m "版本说明" # 附注标签 git push origin --tags # 推送标签
六、高级技巧：提升开发效率
1. 储藏功能（Stash）
临时保存未提交修改：
bash
git stash save "储藏说明" # 保存当前修改
git stash list # 查看储藏列表
git stash apply 储藏ID # 恢复储藏（不删除记录）
git stash pop 储藏ID # 恢复并删除储藏
git stash drop 储藏ID # 删除储藏
2. 自定义命令别名
在.gitconfig文件添加：
ini
[alias]
lg = log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit --date=relative
co = checkout
ci = commit
br = branch
使用git lg即可查看美观的日志视图。
3. 子模块管理
在项目中包含其他仓库：
bash
git submodule add 子模块URL 存放路径
git submodule update --init --recursive # 初始化子模块
七、PyCharm 中使用 Git 的详细指南
1. 配置 Git 环境
首次使用 PyCharm 时，需要配置 Git 路径：
- 打开 PyCharm，进入
File > Settings > Version Control > Git - 点击
Test按钮，确保 PyCharm 能找到 Git 可执行文件 - 如果找不到，手动指定 Git 安装路径（如
C:\Program Files\Git\bin\git.exe）
2. 创建 Git 仓库
（1）创建新项目并关联 Git
- 新建项目后，进入
VCS > Enable Version Control Integration - 选择 Git，点击 OK，项目即被 Git 管理
（2）克隆远程仓库
- 进入
VCS > Get from Version Control - 输入远程仓库 URL，选择本地保存路径，点击 Clone
3. 日常提交与同步
（1）提交代码
- 右键点击项目或文件，选择
Git > Commit Directory - 在弹出的窗口中：
- 左侧选择要提交的文件
- 中间编写提交说明
- 点击
Commit提交到本地仓库 - 或点击
Commit and Push直接推送到远程
（2）拉取与推送
- 拉取：点击工具栏的
Git: master按钮，选择Pull - 推送：点击工具栏的
Git: master按钮，选择Push - 也可以通过
VCS > Git > Pull/Push操作
4. 分支管理可视化
（1）创建分支
- 点击状态栏的当前分支名
- 选择
New Branch - 输入分支名，点击 Create
（2）切换分支
- 点击状态栏的当前分支名
- 在下拉列表中选择目标分支
- 或选择
Checkout输入分支名
（3）合并分支
- 切换到目标分支
- 点击状态栏分支名，选择
Git > Merge Changes - 选择要合并的分支，点击 Merge
（4）可视化分支图
- 进入
Git > Show Git Repository - 在左侧的 Git 工具窗口中，点击 Log 图标
- 可以查看分支关系图，进行快速切换和操作
5. 解决冲突
当拉取或合并出现冲突时：
- PyCharm 会在编辑器顶部显示冲突提示
- 点击
Merge按钮打开合并工具 - 左侧是当前分支内容，右侧是要合并的内容
- 通过中间的按钮选择：
Accept Left：保留当前分支内容Accept Right：接受合并分支内容Merge：手动合并
- 编辑完成后，点击 Apply
6. 查看历史与比较
（1）查看文件历史
- 右键点击文件，选择
Git > Show History - 可以查看文件的修改历史、提交记录
（2）比较版本差异
- 在历史记录中选择两个版本
- 右键选择
Compare - 可以查看两个版本之间的差异
7. 使用 Git 工具窗口
PyCharm 的 Git 工具窗口提供了丰富的功能：
- 提交、拉取、推送等快捷按钮
- 分支管理面板
- 变更列表：查看未提交的修改
- 版本历史：可视化的提交历史
8. 高级功能集成
（1）Git Stash 集成
- 进入
Git > Stash Changes - 可以保存当前未提交修改
- 在需要时通过
Git > Unstash Changes恢复
（2）Rebase 操作
- 进入
Git > Rebase - 选择要 rebase 的分支
- 按照提示完成操作
（3）忽略文件配置
- 在项目根目录创建
.gitignore文件 - 右键点击文件，选择
Git > Add to .gitignore - PyCharm 会自动生成常见的忽略规则
八、常见问题解决方案
1. 初始化仓库失败
- 检查目录是否有权限问题
- 确保目录未被其他版本控制系统（如 SVN）管理
2. 合并冲突无法解决
- 使用
git merge --abort放弃合并 - 重新拉取代码并手动解决冲突
3. 远程仓库连接失败
- 检查网络连接
- 确认远程仓库 URL 正确
- 配置 SSH 密钥（推荐）替代 HTTPS 认证：
bash
ssh-keygen -t rsa -b 4096 -C "你的邮箱" # 将生成的公钥添加到远程仓库账户设置
九、学习资源推荐
- 官方文档：Pro Git
- 交互式教程：Learn Git Branching
- 可视化工具：Sourcetree、GitKraken
- PyCharm 官方 Git 教程：Version Control with Git
通过掌握 Git 的核心功能，开发者可以高效管理代码版本，无缝融入团队协作。记住，版本控制的核心不是工具本身，而是建立规范的开发流程。建议从简单项目开始实践，逐步尝试分支策略、代码审查等协作场景，最终成为 Git 使用的高手。
如果在实践中遇到具体问题，欢迎在评论区留言，我们一起探讨解决方案！