Gitee 新手入门指南：从零开始掌握代码版本管理

🌟 前言：远程代码存储仓库，Gitee 正是太好用了，每天进步一点点，每天记一点点

"代码不是写出来的，是管理出来的。

从今天起，不再担心文件覆盖、不再害怕版本混乱------

用 Gitee 码云，让每一次代码修改都成为可追溯的旅程。"

---

🛠️ 一、为什么选择 Gitee（码云）？

传统痛点	Gitee 解决方案
❌ 代码修改后无法回退	✅ 本地仓库自动保存版本历史
❌ 多人协作时文件覆盖混乱	✅ 远程仓库实现团队协同开发
❌ 每次修改都担心丢失	✅ 本地+远程双重备份，安全无忧
❌ 代码分享困难，依赖邮件传递	✅ 一键分享项目链接，协作超简单

💡 Gitee 真实价值 ：

它不是简单的"代码仓库"，而是团队开发的月光宝盒 ------

保存过去，照亮未来，让代码成为可追溯的资产。

---

📂 二、Gitee 与 Git 的关系

概念	说明
Git	分布式版本控制系统，本地管理代码版本的工具（命令行工具）
Gitee	基于 Git 的远程代码托管平台，类似 GitHub，但更适合国内开发者（无需科学上网）
.git	本地仓库的隐藏目录，Git 用它存储所有版本历史和配置
远程仓库	Gitee 上的仓库，相当于你的"云硬盘"，用于备份和团队协作

🌐 简单比喻 ：

Git 是你的本地笔记本 ，Gitee 是你的云端保险箱 ------

本地写笔记（Git），云端存备份（Gitee）。

---

🚀 三、新手必学：Gitee 从零上手（5 分钟搞定）

✅ 步骤 1：配置 Git 全局信息

bash
编辑
git config --global user.name "你的名字"
git config --global user.email "你的Gitee邮箱"

就是你在初始化仓库的两行代码：

💡 为什么需要？

每次提交时，Git 会记录"谁"做了修改。
注意 ：邮箱必须是 Gitee 注册邮箱（如 16335601+rao-shihao666@user.noreply.gitee.com）

---

✅ 步骤 2：初始化本地仓库

bash
编辑
git init-y

💡 效果 ：

在当前目录快捷生成 .git 隐藏文件夹，标志着本地仓库创建成功。

---

✅ 步骤 3：添加文件到暂存区

bash
编辑
git add .

💡 作用 ：

把所有修改（新文件、修改的文件）放入"待提交队列"（暂存区）。

---

✅ 步骤 4：提交到本地仓库

bash
编辑
git commit -m "第一次提交"

💡 关键点 ：
-m 后面是提交信息，描述这次修改的内容（如 "添加歌词生成功能"）。

---

✅ 步骤 5：关联远程仓库（Gitee）

bash
编辑
git remote add origin https://gitee.com/rao-shihao666/rao-shihaos-factory-warehouse.git

💡 重要提示 ：

替换 rao-shihao666 为你的 Gitee 用户名

替换 rao-shihaos-factory-warehouse 为你的仓库名 （这是我的，你们随意）

---

✅ 步骤 6：首次推送代码到 Gitee

bash
编辑
git push -u origin master

💡 关键参数：

• -u：建立本地分支与远程分支的关联（后续只需 git push）
• origin：远程仓库别名（默认值）
• master：默认分支名（现在通常用 main，但 Gitee 仍支持 master）

---

🌈 四、Gitee 仓库操作速查表

操作	命令	说明
查看远程仓库	git remote -v	验证是否成功关联 Gitee 仓库
从 Gitee 拉取最新代码	git pull origin master	与远程仓库同步最新修改
推送本地修改到 Gitee	git push	无需再写 origin master（已关联）
查看提交历史	git log	查看所有提交记录（包括提交信息）
检查当前状态	git status	查看哪些文件已修改、哪些已暂存

---

⚠️ 五、新手常见错误 & 解决方案

❌ 错误 1：git push 失败，提示 "Permission denied"

原因 ：

未设置 Gitee SSH 密钥（或使用 HTTPS 时密码错误）
解决方案：

1. 在 Gitee 设置中添加 SSH 公钥（推荐）
2. 或使用 HTTPS 时，用个人访问令牌代替密码（Gitee 支持）

❌ 错误 2：.gitignore 没有生效

原因 ：

之前提交了 .env 等敏感文件，Git 已记录这些文件
解决方案：

1. 在 .gitignore 中添加 *.env

2. 删除已提交的 .env：

   bash
   编辑
   git rm --cached .env
   git commit -m "remove .env from repo"
   git push

---

💡 六、Gitee 为什么是新手首选？

对比点	GitHub	Gitee（码云）
网络访问速度	国内访问慢（需科学上网）	国内直连，速度飞快
中文支持	一般	优秀，文档和社区均为中文
个人项目免费	免费	免费（企业版有额外功能）
适合初学者	有一定门槛	零门槛，上手超简单

🌐 真实体验 ：

"在 Gitee 提交代码，就像在朋友圈发照片------简单、快速、无障碍。"

---

✅ 七、终极验证：成功创建 Gitee 仓库

1. 在 Gitee 上创建新仓库（rao-shihaos-factory-warehouse）
2. 按照上面步骤操作
3. 打开 Gitee 仓库页面 → 查看 Commits（提交历史）
4. 你会看到 第一次提交 的记录！

---

🎯 八、下一步：让 Gitee 成为你的开发伙伴

你当前状态	你将拥有的能力
❓ 代码修改后无法回退	✅ 用 git checkout 回滚到任意版本
❓ 单人开发，无法协作	✅ 邀请团队成员，一起写代码
❓ 代码丢失风险高	✅ 本地+远程双重备份，安全无忧
❓ 代码分享困难	✅ 一键生成分享链接，随时展示项目

---

💡 重要提醒 ：
Gitee 不是 Git，而是 Git 的托管平台 。

你学的是 Git（命令行工具），用 Gitee（平台）来存储你的代码。

---

🌟 总结：Gitee 入门三步走

1. 配置 Git ：git config --global
2. 本地操作 ：git init → git add → git commit
3. 远程同步 ：git remote add → git push

✨ 记住 ：
"代码写得好，不如版本管得好。"

从今天开始，用 Gitee 管理你的每一行代码，
每天进步一点点，每天记一点点------
你的代码，终将成为你的作品集。 🚀