在开发流程中，代码托管平台是团队协作与版本管理的核心基础设施。无论是个人项目还是团队工程，掌握 Git 与 Gitee 的协作方式都是必备技能。
Git 与托管平台的关系
Git 本身是一个分布式的版本控制工具，负责本地代码的历史追踪、分支管理和合并。而 Gitee（码云）和 GitHub 则是基于 Git 协议的远程托管服务。
- Git：本地工具，管理代码变更。
- Gitee：国内托管平台，访问速度快，支持私有仓库，适合国内团队。
- GitHub：全球主流平台，开源生态丰富，适合国际协作。
简单来说，Git 负责'管'，Gitee/GitHub 负责'存'。
上传代码到 Gitee 的完整流程
将本地项目推送到 Gitee 主要涉及三个环节：创建远程仓库、初始化本地仓库、关联并推送。
1. 创建远程仓库
登录 gitee.com，点击右上角加号选择'新建仓库'。填写仓库名称、简介等信息。关于初始化选项，如果本地已有代码，建议不要勾选'添加 .gitignore'、'许可证'或'README'，否则会导致本地与远程提交记录冲突。
创建完成后，复制仓库地址。推荐使用 HTTPS 格式，方便新手配置：
https://gitee.com/你的用户名/你的仓库名.git
SSH 格式（[email protected]:...）速度更快但需要配置密钥，新手可暂用 HTTPS。
2. 本地项目初始化
打开终端进入项目目录：
cd /path/to/your/project
如果是全新项目，执行以下命令初始化 Git：
git init
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
git add .
git commit -m "first commit: 初始化项目"
若项目已存在 Git 记录，可跳过 init 步骤，直接进行下一步。
3. 关联远程仓库并推送
将本地仓库指向 Gitee 远程地址：
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 默认主分支为 main，旧版可能为 master，请根据实际情况调整：
git push -u origin main
使用 HTTPS 时，系统会提示输入账号密码。出于安全考虑，建议生成个人访问令牌（Access Token）代替密码使用。
常见问题排查
推送失败：failed to push some refs
这通常是因为远程仓库已包含提交记录（如初始化 README），与本地冲突。解决方法是先拉取远程内容并合并：
