本地代码上传 Gitee 实战：Git 配置与推送详解

搞开发离不开版本控制。Git 负责本地管理，Gitee 和 GitHub 则是托管平台。简单来说，Git 是工具，Gitee/GitHub 用来托管代码，方便多人协作和在线访问。

准备工作

确保已安装 Git 并拥有 Gitee 账号。如果是第一次使用 Git，记得配置全局用户信息，这样提交记录里才会显示你的身份。

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

创建远程仓库

填写仓库名称、简介等信息。公开性根据需求选择：开源选公开，私密项目选私有。注意初始化选项：如果本地已有代码，建议不要勾选'添加 .gitignore'、'许可证'或'README'，否则远程会生成额外文件，导致后续推送冲突。

创建完成后，复制仓库地址。新手建议使用 HTTPS 格式，SSH 需要配置密钥。

HTTPS: https://gitee.com/你的用户名/你的仓库名.git
SSH: [email protected]:你的用户名/你的仓库名.git

本地初始化与关联

在终端进入项目目录，执行以下操作：

1. 全新项目

cd /path/to/your/project
git init
git add .
git commit -m "first commit: 初始化项目"

2. 已有 Git 项目

如果本地已经初始化过，跳过 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 地址，系统会提示输入用户名和密码。为了安全起见，建议开启 Gitee 的个人访问令牌（Access Token）代替密码。SSH 方式则需确保密钥已配置。

刷新 Gitee 仓库页面，确认代码和提交记录已同步，流程就算完成了。

常见问题处理

推送失败：failed to push some refs

通常是因为远程仓库有初始化记录（如 README），与本地冲突。解决方法是先拉取合并：

git pull origin main --allow-unrelated-histories

本地代码上传 Gitee 实战：Git 配置与推送详解