从零开始：用 Git + Gitee 打造你的第一个远程代码仓库（超详细实战）
还在用 U 盘传代码？还在手动备份“项目_最终版_v2_final”？
是时候告别混乱，用 Git + Gitee 实现专业级版本控制与协作了！
本文手把手教你：如何把一个普通文件夹变成可回溯、可共享、可协作的代码仓库。
为什么需要远程仓库？
你可能已经知道：
git init能让本地文件夹变成 Git 仓库- 可以用
git commit记录历史版本
但问题来了：
- 换电脑了怎么办？
- 想和同学/同事一起开发怎么办？
- 电脑硬盘坏了，代码全丢？
答案就是：远程仓库！
Git 是分布式版本控制系统，而 Gitee（码云） 就是你的“云端保险箱”，用于永久保存项目、支持多人协作、实现跨设备同步。
第一步：初始化本地仓库
假设你有一个本地项目文件夹 lesson_zp，它目前只是一个普通目录，没有版本控制能力。
操作：让它“升级”为 Git 仓库
cd lesson_zp
git init
执行后：
- 项目根目录下会生成隐藏文件夹
.git - 此时你拥有了一个本地代码仓库，可以记录文件的不同版本
重要原则：一个项目只应有一个 Git 仓库！多个仓库会导致管理混乱。
第二步：配置你的身份信息
Git 需要知道是谁在提交代码，因此要设置全局用户名和邮箱：
git config --global user.name "xxx"
git config --global user.email "xxxxxx"
建议使用 Gitee 注册邮箱（或 noreply 邮箱），确保提交记录与账号关联。
第三步：首次提交代码到本地仓库
现在，把所有文件加入版本控制：
git add . # 添加所有文件到暂存区
git commit -m "第一次提交" # 提交到本地仓库
好习惯：提交信息要清晰描述本次改动内容，如 “新增登录页面”、“修复按钮样式”。
第四步：在 Gitee 创建远程仓库
- 登录 Gitee
- 点击右上角 “+” → 新建仓库
- 填写仓库名（如
lesson_zp） - 不要勾选“初始化 README” （因为你已有本地代码）
- 点击 创建
你会得到一个仓库地址，例如：
https://gitee.com/zuo-zi-han/lesson_zp.git
第五步：关联本地与远程仓库
使用 git remote add 命令建立连接：
git remote add origin https://gitee.com/zuo-zi-han/lesson_zp.git
origin是远程仓库的默认别名，你可以理解为“主干源头”。
第六步：推送代码到 Gitee
最后，把本地代码推送到云端：
git push -u origin main
常见问题：
如果报错
src refspec main does not match any，说明你的本地分支是master，请改用：git push -u origin master如果提示
remote origin already exists，说明已关联过，用git remote set-url origin <新地址>修改即可。
成功标志
推送成功后，刷新 Gitee 仓库页面，你会看到：
- 所有文件已上传
- 提交历史显示 “第一次提交”
- 从此，你的项目拥有了“时光机” + “云备份” + “协作能力”
日常开发流程（后续操作）
以后每次修改代码，只需三步：
git add .
git commit -m "描述本次改动"
git push
因为首次用了
-u参数，后续git push会自动推送到origin/main（或master）。
补充：分支命名说明
-
Gitee 默认分支名：通常是
master -
GitHub 新仓库默认：
main -
如何查看当前分支？
git branch # * 号表示当前分支
如果不确定，安全做法是：
git push -u origin HEAD
→ 自动推送当前分支，无需指定名字！
结语：Git 不是工具，而是工程素养
通过这个简单流程，你完成了：
- 本地版本控制
- 远程备份
- 协作基础搭建
这不仅是技术操作，更是现代软件开发的基本素养。无论你是学生、自由开发者还是团队成员，掌握 Git 都是迈向专业的第一步。
记住：代码不怕改错，就怕无法回退。而 Git，就是你的后悔药。
