1. 为什么每个开发者都需要掌握Git2005年当Linus Torvalds为了解决Linux内核开发中的版本控制问题时他可能没想到Git会成为当今软件开发的基础设施。作为分布式版本控制系统Git彻底改变了代码协作的方式——它允许每个开发者拥有完整的项目历史副本即使离线也能继续工作这种设计理念完美契合现代开发需求。我在团队协作中见过太多因为版本管理混乱导致的问题代码覆盖、功能丢失、无法回退的错误修改...这些都是缺乏版本控制工具的直接后果。而Git不仅解决了这些问题还通过分支机制让并行开发变得可行。想象一下你正在开发一个新功能突然需要紧急修复线上bug——Git可以让你瞬间切换到生产环境分支修复后再无缝回到功能开发整个过程行云流水。Gitee作为国内领先的代码托管平台为Git提供了更友好的中文界面和更快的访问速度。特别是对于初学者Gitee的文档和社区支持能显著降低学习门槛。我建议国内开发者从Gitee开始Git之旅等熟悉后再接触GitHub等国际平台。提示虽然Git学习曲线较陡但掌握基础20%的功能就能应对80%的日常开发场景。本教程会重点讲解这些高频使用场景。2. 环境准备与基础配置2.1 Git安装全平台指南Windows用户可以直接从Git官网下载安装包。安装时有几个关键选项需要注意选择Use Git from Git Bash only以保证环境纯净选择Checkout as-is, commit Unix-style line endings避免跨平台换行符问题将Git Bash添加到右键菜单方便快速访问macOS用户更简单安装Xcode命令行工具就会自动包含Git也可以通过Homebrew安装最新版brew install gitLinux用户根据发行版选择对应包管理器# Ubuntu/Debian sudo apt-get install git # CentOS/RHEL sudo yum install git安装完成后验证版本git --version2.2 必须做的初始配置安装后第一件事是设置用户信息这些信息会嵌入到每次提交中git config --global user.name 你的姓名 git config --global user.email 你的邮箱我强烈建议配置以下实用选项# 设置默认编辑器为VSCode git config --global core.editor code --wait # 启用彩色输出 git config --global color.ui auto # 设置默认分支名为main(行业新标准) git config --global init.defaultBranch main # 缓存凭据(避免频繁输入密码) git config --global credential.helper cache注意公司项目可能需要使用特定邮箱格式务必与团队保持一致。2.3 Gitee账号准备与SSH配置注册Gitee账号并验证邮箱生成SSH密钥对(比HTTPS更安全方便)ssh-keygen -t ed25519 -C your_emailexample.com将公钥(~/.ssh/id_ed25519.pub)内容添加到Gitee的SSH公钥设置测试连接ssh -T gitgitee.com3. Git核心工作流详解3.1 仓库创建与克隆本地初始化新仓库mkdir project cd project git init echo # 项目README README.md git add README.md git commit -m initial commit克隆现有仓库git clone gitgitee.com:username/repo.git # 或指定目录 git clone gitgitee.com:username/repo.git my-project关联本地仓库到Gitee在Gitee创建新仓库(不要初始化README)执行命令关联git remote add origin gitgitee.com:username/repo.git git push -u origin main3.2 文件状态与基础操作Git文件有四种状态Untracked: 未跟踪的新文件Modified: 已修改但未暂存Staged: 已暂存准备提交Committed: 已提交到本地仓库常用操作流程# 查看当前状态 git status # 添加文件到暂存区 git add filename git add . # 添加所有变更 # 提交到本地仓库 git commit -m 描述性提交信息 # 查看提交历史 git log --oneline --graph实操技巧使用git add -p可以交互式选择要暂存的修改块特别适合一个文件包含多个不相关修改时。3.3 分支管理实战分支是Git最强大的功能之一标准工作流# 创建并切换分支 git checkout -b feature/login # 查看所有分支 git branch -av # 合并分支到main git checkout main git merge feature/login # 删除已合并分支 git branch -d feature/login现代Git推荐使用更直观的switch命令git switch -c feature/login # 创建并切换 git switch main # 切换分支遇到冲突时的解决步骤打开冲突文件搜索标记手动解决冲突保留需要的代码删除冲突标记后保存执行git add标记冲突已解决完成合并提交4. Gitee高级应用场景4.1 团队协作开发流程项目管理员在Gitee创建组织添加团队成员并设置权限(开发者/管理员等)开发者克隆仓库后创建特性分支开发完成后发起Pull Request(PR)团队成员代码评审后合并PR模板示例## 变更描述 [详细说明本次PR的修改内容和原因] ## 相关Issue [关联的Issue编号格式#123] ## 检查清单 - [ ] 代码自测通过 - [ ] 添加了必要的单元测试 - [ ] 更新了相关文档 - [ ] 代码风格符合项目要求4.2 Gitee Pages静态网站部署在仓库根目录添加静态网站文件创建.gitlab-ci.yml文件pages: stage: deploy script: - mkdir .public - cp -r * .public - mv .public public artifacts: paths: - public only: - main推送后访问username.gitee.io/repo查看4.3 代码片段管理Gitee的Snippet功能适合分享代码片段进入代码片段页面创建新片段设置可见性(公开/私有)通过唯一URL分享支持多种语言高亮5. 日常开发高效技巧5.1 别名配置提升效率编辑~/.gitconfig添加[alias] co checkout br branch ci commit st status last log -1 HEAD unstage reset HEAD -- lg log --color --graph --prettyformat:%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)%an%Creset --abbrev-commit5.2 交互式变基整理提交历史git rebase -i HEAD~3常用操作pick: 保留提交reword: 修改提交信息edit: 修改提交内容squash: 合并到前一个提交fixup: 类似squash但丢弃提交信息5.3 储藏临时修改当需要切换分支但有未完成的工作时git stash # 储藏当前修改 git stash list # 查看储藏列表 git stash pop # 恢复最近储藏 git stash apply stash{1} # 恢复指定储藏6. 常见问题排错指南问题现象可能原因解决方案提交时报邮箱错误本地配置与Gitee账号不匹配git config --global user.email 正确邮箱推送被拒绝没有拉取远程最新变更先执行git pull --rebase合并冲突多人修改了同一文件手动解决冲突后标记为已解决误删文件错误执行了rm或git rm使用git checkout -- filename恢复提交了错误内容需要修改最近提交git commit --amend需要回退版本想撤销某些提交git reset --hard commit_id或git revert commit_id7. 企业级Git工作流建议7.1 Git Flow工作流main分支保持稳定可发布状态develop分支作为集成开发分支功能分支从develop创建合并回develop发布时从develop创建release分支紧急修复使用hotfix分支安装Git Flow扩展brew install git-flow-avh # macOS apt-get install git-flow # Linux初始化git flow init -d7.2 提交信息规范推荐使用Angular提交规范type(scope): subject 空行 body 空行 footer常见typefeat: 新功能fix: bug修复docs: 文档变更style: 代码格式refactor: 重构test: 测试相关chore: 构建或辅助工具变更示例feat(login): add OAuth2 support Implement Google and GitHub OAuth2 login flow BREAKING CHANGE: login API response format changed Closes #1238. 安全与备份策略8.1 .gitignore最佳实践示例配置# 操作系统文件 .DS_Store Thumbs.db # 编辑器文件 .idea/ .vscode/ *.swp # 依赖目录 node_modules/ vendor/ # 日志文件 *.log # 敏感信息 .env *.pem重要在项目初期就设置好.gitignore避免敏感信息误提交后难以清除。8.2 仓库定期备份添加多个远程仓库git remote add backup gitgitee.com:username/backup-repo.git定期推送到备份仓库git push --all backup考虑自动化备份方案8.3 敏感信息处理如果误提交了密码等敏感信息使用BFG工具清理历史java -jar bfg.jar --replace-text passwords.txt repo.git强制推送到远程git push --force通知所有协作者重新克隆9. 进阶学习路径9.1 推荐学习资源官方文档Git Book: https://git-scm.com/bookGitee帮助中心: https://gitee.com/help图形化工具GitKrakenSourcetreeVS Code Git扩展在线练习Learn Git Branching: https://learngitbranching.js.org9.2 常见Git可视化工具对比工具优点缺点GitKraken界面美观功能全面部分功能需付费Sourcetree免费支持Git Flow偶尔性能问题GitHub Desktop简单易用功能较基础VS Code Git集成开发环境高级功能有限9.3 参与开源项目实践在Gitee找到感兴趣的项目阅读CONTRIBUTING.md了解贡献指南Fork仓库到自己的账号克隆本地并创建特性分支开发后推送到自己的Fork向原仓库发起Pull Request根据反馈迭代修改我在实际项目中最常遇到的Git问题是分支污染——太多长期存在的特性分支导致仓库混乱。解决方案是定期清理已合并分支并使用git remote prune origin删除远程已不存在的分支引用。另一个实用技巧是git reflog它能显示所有Git操作记录是找回误删提交的最后保障。 Git与Gitee入门：开发者必备的版本控制技能
1. 为什么每个开发者都需要掌握Git2005年当Linus Torvalds为了解决Linux内核开发中的版本控制问题时他可能没想到Git会成为当今软件开发的基础设施。作为分布式版本控制系统Git彻底改变了代码协作的方式——它允许每个开发者拥有完整的项目历史副本即使离线也能继续工作这种设计理念完美契合现代开发需求。我在团队协作中见过太多因为版本管理混乱导致的问题代码覆盖、功能丢失、无法回退的错误修改...这些都是缺乏版本控制工具的直接后果。而Git不仅解决了这些问题还通过分支机制让并行开发变得可行。想象一下你正在开发一个新功能突然需要紧急修复线上bug——Git可以让你瞬间切换到生产环境分支修复后再无缝回到功能开发整个过程行云流水。Gitee作为国内领先的代码托管平台为Git提供了更友好的中文界面和更快的访问速度。特别是对于初学者Gitee的文档和社区支持能显著降低学习门槛。我建议国内开发者从Gitee开始Git之旅等熟悉后再接触GitHub等国际平台。提示虽然Git学习曲线较陡但掌握基础20%的功能就能应对80%的日常开发场景。本教程会重点讲解这些高频使用场景。2. 环境准备与基础配置2.1 Git安装全平台指南Windows用户可以直接从Git官网下载安装包。安装时有几个关键选项需要注意选择Use Git from Git Bash only以保证环境纯净选择Checkout as-is, commit Unix-style line endings避免跨平台换行符问题将Git Bash添加到右键菜单方便快速访问macOS用户更简单安装Xcode命令行工具就会自动包含Git也可以通过Homebrew安装最新版brew install gitLinux用户根据发行版选择对应包管理器# Ubuntu/Debian sudo apt-get install git # CentOS/RHEL sudo yum install git安装完成后验证版本git --version2.2 必须做的初始配置安装后第一件事是设置用户信息这些信息会嵌入到每次提交中git config --global user.name 你的姓名 git config --global user.email 你的邮箱我强烈建议配置以下实用选项# 设置默认编辑器为VSCode git config --global core.editor code --wait # 启用彩色输出 git config --global color.ui auto # 设置默认分支名为main(行业新标准) git config --global init.defaultBranch main # 缓存凭据(避免频繁输入密码) git config --global credential.helper cache注意公司项目可能需要使用特定邮箱格式务必与团队保持一致。2.3 Gitee账号准备与SSH配置注册Gitee账号并验证邮箱生成SSH密钥对(比HTTPS更安全方便)ssh-keygen -t ed25519 -C your_emailexample.com将公钥(~/.ssh/id_ed25519.pub)内容添加到Gitee的SSH公钥设置测试连接ssh -T gitgitee.com3. Git核心工作流详解3.1 仓库创建与克隆本地初始化新仓库mkdir project cd project git init echo # 项目README README.md git add README.md git commit -m initial commit克隆现有仓库git clone gitgitee.com:username/repo.git # 或指定目录 git clone gitgitee.com:username/repo.git my-project关联本地仓库到Gitee在Gitee创建新仓库(不要初始化README)执行命令关联git remote add origin gitgitee.com:username/repo.git git push -u origin main3.2 文件状态与基础操作Git文件有四种状态Untracked: 未跟踪的新文件Modified: 已修改但未暂存Staged: 已暂存准备提交Committed: 已提交到本地仓库常用操作流程# 查看当前状态 git status # 添加文件到暂存区 git add filename git add . # 添加所有变更 # 提交到本地仓库 git commit -m 描述性提交信息 # 查看提交历史 git log --oneline --graph实操技巧使用git add -p可以交互式选择要暂存的修改块特别适合一个文件包含多个不相关修改时。3.3 分支管理实战分支是Git最强大的功能之一标准工作流# 创建并切换分支 git checkout -b feature/login # 查看所有分支 git branch -av # 合并分支到main git checkout main git merge feature/login # 删除已合并分支 git branch -d feature/login现代Git推荐使用更直观的switch命令git switch -c feature/login # 创建并切换 git switch main # 切换分支遇到冲突时的解决步骤打开冲突文件搜索标记手动解决冲突保留需要的代码删除冲突标记后保存执行git add标记冲突已解决完成合并提交4. Gitee高级应用场景4.1 团队协作开发流程项目管理员在Gitee创建组织添加团队成员并设置权限(开发者/管理员等)开发者克隆仓库后创建特性分支开发完成后发起Pull Request(PR)团队成员代码评审后合并PR模板示例## 变更描述 [详细说明本次PR的修改内容和原因] ## 相关Issue [关联的Issue编号格式#123] ## 检查清单 - [ ] 代码自测通过 - [ ] 添加了必要的单元测试 - [ ] 更新了相关文档 - [ ] 代码风格符合项目要求4.2 Gitee Pages静态网站部署在仓库根目录添加静态网站文件创建.gitlab-ci.yml文件pages: stage: deploy script: - mkdir .public - cp -r * .public - mv .public public artifacts: paths: - public only: - main推送后访问username.gitee.io/repo查看4.3 代码片段管理Gitee的Snippet功能适合分享代码片段进入代码片段页面创建新片段设置可见性(公开/私有)通过唯一URL分享支持多种语言高亮5. 日常开发高效技巧5.1 别名配置提升效率编辑~/.gitconfig添加[alias] co checkout br branch ci commit st status last log -1 HEAD unstage reset HEAD -- lg log --color --graph --prettyformat:%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)%an%Creset --abbrev-commit5.2 交互式变基整理提交历史git rebase -i HEAD~3常用操作pick: 保留提交reword: 修改提交信息edit: 修改提交内容squash: 合并到前一个提交fixup: 类似squash但丢弃提交信息5.3 储藏临时修改当需要切换分支但有未完成的工作时git stash # 储藏当前修改 git stash list # 查看储藏列表 git stash pop # 恢复最近储藏 git stash apply stash{1} # 恢复指定储藏6. 常见问题排错指南问题现象可能原因解决方案提交时报邮箱错误本地配置与Gitee账号不匹配git config --global user.email 正确邮箱推送被拒绝没有拉取远程最新变更先执行git pull --rebase合并冲突多人修改了同一文件手动解决冲突后标记为已解决误删文件错误执行了rm或git rm使用git checkout -- filename恢复提交了错误内容需要修改最近提交git commit --amend需要回退版本想撤销某些提交git reset --hard commit_id或git revert commit_id7. 企业级Git工作流建议7.1 Git Flow工作流main分支保持稳定可发布状态develop分支作为集成开发分支功能分支从develop创建合并回develop发布时从develop创建release分支紧急修复使用hotfix分支安装Git Flow扩展brew install git-flow-avh # macOS apt-get install git-flow # Linux初始化git flow init -d7.2 提交信息规范推荐使用Angular提交规范type(scope): subject 空行 body 空行 footer常见typefeat: 新功能fix: bug修复docs: 文档变更style: 代码格式refactor: 重构test: 测试相关chore: 构建或辅助工具变更示例feat(login): add OAuth2 support Implement Google and GitHub OAuth2 login flow BREAKING CHANGE: login API response format changed Closes #1238. 安全与备份策略8.1 .gitignore最佳实践示例配置# 操作系统文件 .DS_Store Thumbs.db # 编辑器文件 .idea/ .vscode/ *.swp # 依赖目录 node_modules/ vendor/ # 日志文件 *.log # 敏感信息 .env *.pem重要在项目初期就设置好.gitignore避免敏感信息误提交后难以清除。8.2 仓库定期备份添加多个远程仓库git remote add backup gitgitee.com:username/backup-repo.git定期推送到备份仓库git push --all backup考虑自动化备份方案8.3 敏感信息处理如果误提交了密码等敏感信息使用BFG工具清理历史java -jar bfg.jar --replace-text passwords.txt repo.git强制推送到远程git push --force通知所有协作者重新克隆9. 进阶学习路径9.1 推荐学习资源官方文档Git Book: https://git-scm.com/bookGitee帮助中心: https://gitee.com/help图形化工具GitKrakenSourcetreeVS Code Git扩展在线练习Learn Git Branching: https://learngitbranching.js.org9.2 常见Git可视化工具对比工具优点缺点GitKraken界面美观功能全面部分功能需付费Sourcetree免费支持Git Flow偶尔性能问题GitHub Desktop简单易用功能较基础VS Code Git集成开发环境高级功能有限9.3 参与开源项目实践在Gitee找到感兴趣的项目阅读CONTRIBUTING.md了解贡献指南Fork仓库到自己的账号克隆本地并创建特性分支开发后推送到自己的Fork向原仓库发起Pull Request根据反馈迭代修改我在实际项目中最常遇到的Git问题是分支污染——太多长期存在的特性分支导致仓库混乱。解决方案是定期清理已合并分支并使用git remote prune origin删除远程已不存在的分支引用。另一个实用技巧是git reflog它能显示所有Git操作记录是找回误删提交的最后保障。