在开发过程中，代码托管平台是必备工具。无论是新手还是资深开发者，掌握将代码上传到 Gitee 或 GitHub 都是核心技能。本文重点讲解如何上传项目至 Gitee，并梳理 Git 与托管平台的关系。
Git 与托管平台简介
Git 是分布式版本控制工具，负责本地管理代码历史、团队协作和合并。Gitee 是国内的 Git 托管平台，访问速度快，支持私有仓库。GitHub 则是全球知名的开源平台。简单来说，Git 是本地工具，Gitee 和 GitHub 是云端仓库。
上传代码到 Gitee
主要分为三步：创建远程仓库、初始化本地项目、关联并推送。
1. 创建远程仓库
登录 Gitee 官网，点击右上角 + 号选择'新建仓库'。填写仓库名、简介等信息。公开性根据需求选择：公开适合开源，私有保护隐私。建议不要勾选'添加 .gitignore'、'许可证'或'README'，以免本地已有代码时产生冲突。
创建成功后，复制仓库地址。格式通常为 HTTPS 或 SSH。新手建议使用 HTTPS 格式：https://gitee.com/用户名/仓库名.git。
2. 本地项目准备
进入项目目录：
cd /path/to/your/project
如果是全新项目，执行初始化：
git init
配置用户信息（首次使用）：
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
添加文件并提交：
git add .
git commit -m "first commit: 初始化项目"
若项目已用 Git 管理，可跳过 init 步骤。
3. 关联远程仓库
添加远程地址：
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，请根据实际情况调整。HTTPS 推送会要求输入账号密码，建议使用个人访问令牌代替明文密码。
常见问题处理
推送失败：failed to push some refs
通常因远程仓库已有提交记录（如创建了 README）导致冲突。解决方法：
git pull origin main --allow-unrelated-histories
解决冲突后再推送。
忽略特定文件
在项目根目录创建 .gitignore，写入需要忽略的内容，例如：
node_modules/
*.log
.env
.DS_Store
掌握这些操作后，你就能高效管理代码版本。遇到具体问题，查阅官方文档或社区资源通常能找到答案。
