Gitee完全新手教程

🚀 Gitee完全新手教程

一、注册与准备

1. 注册账号

   • 访问 gitee.com
   • 使用手机号或邮箱注册
   • 完善个人资料（用户名很重要，会出现在仓库地址中）

2. 安装Git

   • Windows: 下载 Git Bash
   • Mac: 使用 Homebrew brew install git
   • Linux: sudo apt-get install git

3. 配置本地Git

   git config --global user.name "你的用户名"
   git config --global user.email "你的邮箱"
   

二、创建第一个仓库（详细步骤）

步骤1：点击创建按钮

• 在Gitee首页点击右上角 + → 新建仓库

步骤2：填写基础信息

• 仓库名称: 例如 learning-python
• 路径: 自动生成，保持与仓库名一致
• 介绍: 简单描述，如"我的Python学习笔记"

步骤3：关键设置

• ✅ 初始化仓库
• ✅ 设置模板 → 只选 Readme文件
• ❌ 分支模型 → 不选
• ✅ .gitignore → 选择你学习的语言
• ✅ 开源许可证 → 选择 MIT License

步骤4：创建完成

点击"创建"按钮，你的第一个仓库就诞生了！

三、本地操作指南

1. 克隆仓库到本地

git clone https://gitee.com/你的用户名/仓库名.git
cd 仓库名

2. 日常工作流程

# 1. 添加文件后
git add .# 2. 提交更改
git commit -m "描述这次提交的内容"# 3. 推送到Gitee
git push origin master

3. 常用命令总结

# 查看状态
git status# 查看提交历史
git log# 拉取远程更新
git pull# 查看文件差异
git diff

四、重要概念解释

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

2. 提交了错误文件

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

3. 忘记提交某些文件

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

八、学习路径建议

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 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管理所有代码，将其变成一种习惯。每次遇到问题都是学习的机会，通过解决问题来深化理解。