本地代码上传 Gitee 实战:Git 配置与推送详解
搞开发离不开版本控制。Git 负责本地管理,Gitee 和 GitHub 则是托管平台。简单来说,Git 是工具,Gitee/GitHub 用来托管代码,方便多人协作和在线访问。
准备工作
确保已安装 Git 并拥有 Gitee 账号。如果是第一次使用 Git,记得配置全局用户信息,这样提交记录里才会显示你的身份。
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
创建远程仓库
登录 gitee.com,点击右上角的 + 号选择'新建仓库'。
填写仓库名称、简介等信息。公开性根据需求选择:开源选公开,私密项目选私有。注意初始化选项:如果本地已有代码,建议不要勾选'添加 .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


