在开发流程中，版本控制工具几乎是每位开发者的标配。无论是刚入门的新手，还是管理多个项目的资深工程师，掌握如何将本地代码托管到 Gitee 或 GitHub 都是必备技能。
本文将带你梳理 Git 的基本概念，并详细演示如何将项目上传至 Gitee，同时厘清 Git、Gitee 与 GitHub 之间的关系，帮助你在使用这些工具时不再迷茫。
核心概念：工具与平台
Git 是开源的分布式版本控制工具，负责本地代码的历史追踪、回退和合并。而 Gitee 和 GitHub 则是基于 Git 协议的托管平台。
- Git：本地管理工具，处理版本历史。
- Gitee：国内托管平台，访问速度快，支持私有仓库，适合国内团队或个人隐私项目。
- GitHub：全球知名平台，开源生态丰富，适合国际协作。
简单来说，Git 负责'管'，Gitee/GitHub 负责'存'。
第一步：创建远程仓库
登录 gitee.com 后，点击右上角的 + 号选择'新建仓库'。填写仓库名称（如 my-project）、简介等信息。
关于初始化选项，建议不要勾选'添加 .gitignore'、'许可证'或'README'。如果本地已有代码，勾选这些会生成额外文件，导致推送时出现冲突。
创建完成后，复制仓库地址。常见格式如下：
- HTTPS：
https://gitee.com/你的用户名/你的仓库名.git - SSH：
[email protected]:你的用户名/你的仓库名.git（需配置密钥，新手推荐 HTTPS）
第二步：本地环境准备
打开终端进入项目目录：
cd /path/to/your/project
如果是全新项目，执行以下初始化操作：
git init
首次使用 Git 需配置用户信息：
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
将文件加入暂存区并提交：
git add .
git commit -m "first commit: 初始化项目"
若项目已存在 Git 记录，可跳过 git init 直接进入下一步。
第三步：关联并推送代码
在本地项目根目录下，将远程仓库地址添加到 Git：
git remote add origin https://gitee.com/你的用户名/你的仓库名.git
如果提示 fatal: remote origin already exists，说明已存在远程地址，可使用以下命令修改：
git remote set-url origin https://gitee.com/你的用户名/你的仓库名.git
验证关联是否成功：
git remote -v
最后推送代码：
git push -u origin main
注意：新版 Git 默认主分支为 main，旧版可能是 master。如遇分支名错误，请将命令中的 替换为 。
