Gitee 版本控制新手入门指南

四、重要概念解释

1. 仓库（Repository）

• 就是你的项目文件夹，包含所有代码和历史记录

2. 分支（Branch）

• 主分支：通常叫 master 或 main
• 功能分支：开发新功能时创建的分支
• 新手建议: 先在主分支上练习，熟练后再学习分支管理

3. 提交（Commit）

• 每次提交都是一次"存档"，记录了你做了哪些修改
• 提交信息要写清楚，方便以后回顾

4. 推送（Push）和拉取（Pull）

• Push: 将本地更改上传到 Gitee
• Pull: 将 Gitee 上的更新下载到本地

五、新手注意事项 ⚠️

🚫 绝对不要做

1. 不要提交大文件（超过 100MB）
   • 会影响仓库性能
   • 解决方案：使用 .gitignore 过滤
2. 不要直接在主分支上做危险实验
   • 可以先创建测试分支
   • 或者本地备份后再操作
3. 不要提交敏感信息
   • 密码、API 密钥、配置文件等
   • 一旦提交很难彻底删除

✅ 推荐做法

1. 勤提交，少推送
   • 本地可以频繁 commit
   • 完成一个功能后再 push
2. 写好提交信息
   • 坏例子：git commit -m "修复"
   • 好例子：git commit -m "修复用户登录时的密码验证 bug"
3. 定期同步
   • 开始工作前先 git pull
   • 避免合并冲突

六、.gitignore 模板示例

根据你的学习方向选择：

Python 学习

# 虚拟环境
venv/
.env/
# 缓存文件
__pycache__/
*.pyc
# IDE 配置
.vscode/
.idea/

前端学习

# 依赖目录
node_modules/
dist/
# 日志文件
*.log
npm-debug.log*

七、遇到问题怎么办？

常见问题解决

1. 推送被拒绝
   • 先执行 git pull --rebase origin master
   • 然后再 git push

忘记提交某些文件

git add 漏掉的文件
git commit --amend # 合并到上次提交

提交了错误文件

# 撤销上次提交
git reset --soft HEAD~1 # 然后重新提交

八、学习路径建议

1. 熟悉基本操作（clone, add, commit, push）
2. 学习查看历史记录和文件差异
3. 练习解决简单冲突
4. 尝试创建和使用分支

九、第 1 周详细学习计划：掌握基础操作

每日练习任务

周一：环境搭建

• 完成 Gitee 账号注册
• 安装并配置 Git
• 创建第一个测试仓库

周二：本地仓库操作

# 创建学习目录
mkdir gitee-learning
cd gitee-learning
# 初始化本地仓库
git init
# 创建第一个文件
echo "# 我的学习笔记" > README.md
git add README.md
git commit -m "添加 README 文件"

周三：连接远程仓库

• 在 Gitee 创建名为 gitee-practice 的仓库
• 将本地仓库与远程关联

git remote add origin https://gitee.com/你的用户名/gitee-practice.git
git push -u origin master

周四：日常工作流练习

• 修改 README 文件
• 添加新的学习笔记文件
• 完成一次完整的 add→commit→push 流程

周五：复习巩固

• 回顾本周所有操作
• 尝试在不同电脑上克隆仓库并操作
• 总结遇到的问题和解决方案

十、第 2 周学习计划：查看与比较

核心技能培养

周一：学习查看状态和历史

# 查看当前状态
git status
# 查看详细提交历史
git log --oneline --graph
# 查看特定文件的修改历史
git log -p filename

周二：文件差异比较

# 比较工作区与暂存区的差异
git diff
# 比较暂存区与最新提交的差异
git diff --staged
# 比较两个提交之间的差异
git diff commit_id1 commit_id2

周三：撤销操作练习

# 撤销对文件的修改（危险操作，谨慎使用）
git checkout -- filename
# 从暂存区移除文件
git reset HEAD filename
# 修改上次提交信息
git commit --amend

周四：.gitignore 深入理解

• 练习编写自定义 .gitignore 规则
• 理解通配符的使用：*、?、[]
• 学习忽略已跟踪文件的方法

周五：实战练习

• 创建一个包含多种文件类型的项目
• 练习使用 diff 排查问题
• 编写详细的提交信息

十一、第 3 周学习计划：冲突解决

冲突处理训练

周一：理解冲突产生的原因

• 模拟多人协作场景
• 在两个地方修改同一文件的同一行
• 观察冲突产生的过程

周二：学习合并冲突解决

# 当 pull 时出现冲突
git pull origin master
# 手动解决冲突后
git add .
git commit -m "解决合并冲突"

周三：使用图形化工具

• 学习使用 VSCode 的冲突解决工具
• 尝试使用 GitKraken 或 SourceTree
• 比较不同工具的优缺点

周四：rebase 练习

# 使用 rebase 保持线性历史
git pull --rebase origin master
# 解决 rebase 过程中的冲突
git add .
git rebase --continue

周五：预防冲突的最佳实践

• 勤推送，减少冲突机会
• 在开始工作前先 pull 更新
• 团队成员间及时沟通

十二、第 4 周学习计划：分支管理

分支操作全面掌握

周一：创建和切换分支

# 查看所有分支
git branch -a
# 创建新分支
git branch feature-new
# 切换分支
git checkout feature-new
# 或者使用更现代的方式
git switch feature-new

周二：分支合并练习

# 在 feature 分支完成开发后
git switch master
git merge feature-new
# 使用 no-ff 保留分支历史
git merge --no-ff feature-new

周三：远程分支操作

# 推送本地分支到远程
git push -u origin feature-new
# 跟踪远程分支
git checkout --track origin/feature-new
# 删除远程分支
git push origin --delete feature-new

周四：分支策略学习

• 了解 Git Flow 工作流
• 学习主分支、开发分支、功能分支的作用
• 为个人项目设计合适的分支策略

周五：综合实战项目

• 模拟真实项目开发流程
• 从功能开发到测试再到合并
• 完整走一遍分支工作流

十三、进阶学习建议

完成基础学习后的方向

1. 参与开源项目

• 在 Gitee 上寻找感兴趣的开源项目
• 从提交 issue 开始
• 尝试修复简单的 bug

2. 学习 Git 高级功能

• 存储临时修改：git stash
• 二分法排查问题：git bisect
• 子模块管理：git submodule

3. 搭建个人博客或项目集

• 使用 Gitee Pages 部署静态网站
• 建立个人技术博客
• 展示学习成果和项目

持续学习资源

• Gitee 官方文档
• Pro Git 电子书（免费）
• GitHub Learning Lab 互动教程
• 技术社区的 Git 相关文章

记住，熟练掌握 Git 需要时间和实践。建议在学习编程的同时，坚持使用 Git 管理所有代码，将其变成一种习惯。每次遇到问题都是学习的机会，通过解决问题来深化理解。