Git 是分布式版本控制的核心工具，而 Gitee 则是国内常用的托管平台。将本地项目推送到云端，通常包含创建仓库、初始化本地环境、关联远程地址及推送四个关键阶段。以下流程基于标准 Git 操作，适用于大多数开发场景。
准备工作：环境与仓库
在开始之前，确保已安装 Git 客户端。若初次使用，建议先配置全局用户信息：
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
随后登录 Gitee 官网，点击右上角"+"号选择'新建仓库'。填写项目名称与简介时，注意不要勾选'添加 .gitignore'、'许可证'或'初始化 README'，除非你希望远程仓库自带这些文件。勾选这些选项会导致远程已有提交记录，后续推送时可能引发冲突。创建完成后，复制仓库的 HTTPS 或 SSH 地址备用。
本地项目初始化
进入本地项目目录，执行以下命令完成初始化：
cd /path/to/your/project
git init
git add .
git commit -m "first commit: 初始化项目"
如果项目已存在 Git 历史，可跳过 git init 和 commit 步骤，直接进行下一步。
关联远程仓库并推送
将本地仓库与 Gitee 建立连接。在终端执行：
git remote add origin https://gitee.com/你的用户名/你的仓库名.git
若提示 remote origin already exists，可使用 git remote set-url origin <URL> 修改地址。验证连接状态：
git remote -v
确认无误后，推送主分支代码。新版 Git 默认分支名为 main，旧版为 master，请根据实际情况调整：
git push -u origin main
HTTPS 方式会要求输入账号密码，出于安全考虑，建议使用个人访问令牌（Token）替代密码。SSH 方式则需提前配置好密钥。
常见问题处理
推送失败时出现 failed to push some refs，通常是因为远程仓库已初始化（如创建了 README），与本地空仓库冲突。此时需先拉取远程内容并合并：
git pull origin main --allow-unrelated-histories
解决冲突后再执行推送。此外，可通过根目录下的 .gitignore 文件忽略不需要上传的文件，例如 node_modules/ 或 .env 配置文件。
掌握上述流程，即可实现本地代码的高效托管与协作管理。
