Git Extensions 本地已有代码上传 Gitee + 项目独立账号配置完整教程

核心要点：Gitee 新建空仓库（不要勾选 README / 初始化）→Git Extensions 打开本地项目→项目单独配置提交用户名 / 邮箱（项目级账号，不影响全局）→关联 Gitee 远程地址→提交 + 推送；HTTPS 用 Gitee 私人令牌代替密码登录

一、Gitee 网页端提前准备（关键）

1. 登录 Gitee → 右上角+→新建仓库
2. 填写仓库名，私有 / 公开自选，取消勾选：初始化 README、.gitignore、开源协议（本地已有代码，勾选会文件冲突）
3. 创建完成，复制仓库HTTPS 地址：https://gitee.com/你的Gitee账号/仓库名.git（优先 HTTPS，简单免配 SSH 密钥）
4. 生成 Gitee 私人令牌 PAT（必做，Gitee 不再支持明文密码登录 HTTPS）
    
   头像→设置→安全设置→私人令牌→生成新令牌，勾选权限：repo(仓库读写)、user_info，复制保存令牌（替代密码，只显示一次）

二、Git Extensions 打开本地项目

1. 打开 Git Extensions → 左上角打开仓库→选中本地项目根文件夹
   • 项目没初始化 git：顶部菜单仓库→初始化仓库，弹出框直接确定，项目生成隐藏.git文件夹
   • 已经是 git 仓库：直接进入项目

三、【重点：项目级单独配置账号（仅当前项目生效，全局不受影响）】

需求：单个项目自定义提交用户名、邮箱、Gitee 登录账号，不和电脑全局 git 账号混用

方式 1：Git Extensions 图形化配置（推荐）

1. 顶部菜单 设置→仓库设置（Repository settings，仅本项目）（不要选全局设置）
2. 在User栏：
   • Name：填写这个项目对应的 Gitee 昵称 / 用户名（提交记录作者名）
   • Email：填写该 Gitee 账号绑定邮箱（提交记录邮箱）

   该配置写入项目.git/config，只对当前项目生效，优先级＞全局配置

3. 切换到Remote（远程），后续填 Gitee 地址

方式 2：项目内命令行（备用）

Git Extensions 顶部命令行(Git Bash)，执行（仅本项目）：

git config --local user.name "项目专属用户名"
git config --local user.email "项目对应gitee邮箱"
# 锁定本项目HTTPS登录固定Gitee账号（避免自动切全局账号）
git config --local credential.username "你的Gitee登录账号"

　　

--local = 当前项目配置，项目级账号；--global=整台电脑全局账号

四、Git Extensions 绑定 Gitee 远程仓库地址

1. 顶部菜单 推送(向上箭头图标) → 弹窗点管理远程 (Manage remotes)
2. 新增远程：
   • 名称：固定填origin（默认远程名）
   • URL：粘贴刚才复制的 Gitee HTTPS 仓库地址
   • 协议选 HTTPS，不需要填私钥（SSH 才用）→添加→保存

新增远程地址

远程列表保存

 

五、本地提交代码 + 推送到 Gitee

1. 暂存并提交本地代码

1. Git Extensions 左侧更改，勾选全部待上传文件；
2. 下方填写提交备注：init:项目首次提交→提交 (Commit)，本地生成版本记录

2. 推送代码到 Gitee

1. 再次点顶部推送 (向上箭头)，远程选origin，分支默认main/master（Gitee 新版默认 main），勾选设置上游跟踪分支（Set upstream）→确定推送
2. 弹出账号密码框：
   • 用户名：Gitee 登录账号
   • 密码：粘贴之前生成的 Gitee 私人令牌 PAT（不是网页登录密码）
3. 勾选记住凭证，后续推送不再重复输账号密码（凭证绑定本项目配置的账号）

六、常见报错处理

1. fatal: refusing to merge unrelated histories：Gitee 建仓误勾选 README，先执行一次拉取再推送

git pull origin main --allow-unrelated-histories

　　

1. Git Extensions：拉取→高级→勾选允许合并不相关历史→拉取后再推送
2. 输密码一直报错：确认用私人令牌 PAT 代替密码，令牌权限勾选 repo
3. 提交作者信息不对：回到仓库设置核对项目级 user.name/user.email

补充：想用 SSH 免密登录（可选，不用每次输令牌）

1. Git Extensions→工具→生成 SSH 密钥 (Putty)，生成.ppk私钥；
2. Gitee→设置→SSH 公钥，粘贴公钥内容；
3. 远程地址改用 SSH 格式：git@gitee.com:账号/仓库.git，管理远程替换 URL，推送自动用密钥认证