Git实战：如何将本地代码安全推送到Gitee私人仓库

Git实战：如何将本地代码安全推送到Gitee私人仓库

在多Git账户环境下实现项目级配置隔离与远程仓库托管

背景与场景

在日常开发中，我们常常面临这样一个问题：公司内部使用GitLab进行协同开发，而我们个人可能同时维护着托管在Gitee或GitHub上的私人项目。此时，如果全局配置了公司的user.name和user.email，私人项目的提交记录便会“污染”个人信息，反之亦然。

本文将完整记录如何通过Git的 项目级配置（local） 实现配置隔离，并完成本地代码到Gitee私人仓库的推送过程。这套方案适用于所有希望在同一设备上无缝切换多个Git托管平台（Gitee、GitHub、GitLab）的开发者。

环境准备

在开始之前，请确保本地已安装Git，并已在Gitee平台完成注册。

git --version

若未安装，可前往 Git官网 下载对应操作系统的安装包。

第一步：在Gitee创建私人仓库

1. 登录Gitee，点击右上角「+」→「新建仓库」。
2. 填写仓库信息：
   • 仓库名称：建议与本地项目文件夹名称一致，便于管理。
   • 归属：选择个人空间地址。
   • 路径：系统会根据仓库名称自动生成，这是仓库URL的唯一标识符，建议不做修改。若需自定义，仅可使用英文、数字与连字符（-）。
   • 仓库介绍：简要说明项目用途（选填）。
   • 开源/私有：选择「私有」。
3. 关键注意事项：取消勾选「使用Readme文件初始化这个仓库」。因为本地已存在代码，远程仓库保持完全空白可避免后续推送时出现合并冲突。
4. 点击「创建」，仓库生成后复制其HTTPS地址（例如：https://gitee.com/用户名/仓库名.git）。

第二步：Git项目级配置隔离

此为本文核心步骤。通过配置本项目的user.name和user.email，确保提交记录中显示私人身份，而公司全局配置不受任何影响。

进入本地项目根目录，打开终端（Git Bash或终端工具），执行以下操作：

2.1 初始化本地仓库

git init

此时项目根目录下会生成 .git 隐藏文件夹，表示Git仓库初始化成功。

2.2 检查并配置项目级用户信息

# 查看当前项目配置（此时可能会显示公司全局信息）
git config user.name
git config user.email

# 设置本项目专属的用户信息（注意：不加 --global 参数）
git config user.name "你的Gitee昵称"
git config user.email "你的Gitee注册邮箱"

原理说明：Git配置存在三级优先级——系统级（system）< 全局级（global）< 项目级（local）。项目级配置会覆盖全局配置，且仅对当前仓库生效，其他项目依然沿用全局配置，完美实现环境隔离。

2.3 验证配置

查看项目根目录下的 .git/config 文件，可确认配置已写入：

[user]
    name = 你的Gitee昵称
    email = 你的Gitee注册邮箱

第三步：关联远程仓库

将本地仓库与Gitee远程仓库建立连接。

git remote add origin https://gitee.com/用户名/仓库名.git

如之前已关联过其他远程地址，可先删除再重新添加：

git remote rm origin
git remote add origin <新地址>

验证远程仓库地址：

git remote -v

第四步：提交本地代码

将本地项目文件纳入版本控制并生成第一次提交记录。

# 将所有文件添加至暂存区（已配置 .gitignore 忽略无需提交的文件）
git add .

# 提交至本地仓库
git commit -m "feat: 项目首次提交"

提交信息建议遵循 Conventional Commits 规范，使提交历史清晰易读。

第五步：推送至远程仓库

git push -u origin master

• -u：首次推送时建立本地分支与远程分支的跟踪关系，后续可直接使用 git push。
• 若默认分支为 main，则命令为 git push -u origin main。

推送凭证问题：使用HTTPS协议推送时，Gitee会要求输入账号密码。请注意：

• 账号：填写个人空间地址（可在Gitee「设置」→「个人资料」中查看），而非手机号或邮箱。
• 密码：建议使用私人令牌替代登录密码。生成方式：Gitee「设置」→「安全设置」→「私人令牌」→「生成新令牌」，复制后粘贴即可。

推送成功后，刷新Gitee仓库页面，代码已完整上传。

风险规避与常见问题

1. 推送被拒绝（non-fast-forward）

若远程仓库存在初始文件（如误选了README初始化），需先拉取合并：

git pull --rebase origin master
git push origin master

2. 提交人信息错误

若某次提交已使用全局信息推送，可通过 git commit --amend --reset-author 修正最近一次提交的作者信息。

3. 多平台远程地址混淆

建议不同项目明确区分远程仓库域名：

# 私人项目
git remote -v  # 应指向 gitee.com

# 公司项目
git remote -v  # 应指向公司GitLab域名

总结

通过以上操作，我们完成了以下目标：

维度	实现效果
配置隔离	私人项目使用独立的 user.name 与 user.email，不影响公司全局配置
远程托管	成功将本地代码推送至Gitee私有仓库，代码得到安全托管
提交规范	遵循约定式提交规范，提交历史清晰可读
凭证管理	使用私人令牌替代密码，提升账户安全性

本文所述方法适用于所有需要在同一设备管理多个Git账户的场景。掌握项目级配置的优先级原理，即可灵活应对各种开发环境。

---

技术交流：如有疑问或建议，欢迎在评论区留言讨论。