整体分两大方式:SSH(免密,优先推荐适配你的github)、HTTPS‑Token方式,分远端GitHub网页配置 + TortoiseGit本地配置两步完成。
前置准备(GitHub网页配置远端仓库)
-
登录GitHub网站,新建仓库(New repository);仓库名和本地项目一致(
manager),不要勾选Add a README.md(避免首次推送冲突),创建仓库后复制SSH地址:git@github.com:yuepei9527/manager.git
-
把公钥配置到GitHub:
- 你之前Git‑Bash生成
id_ed25519.pub里面全部内容复制; - GitHub头像 → Settings → SSH and GPG keys → New SSH key,粘贴公钥保存。
- 你之前Git‑Bash生成
注意:TortoiseGit有两种SSH模式:
方案A:沿用Git‑Bash的OpenSSH密钥(推荐,不用转换ppk文件);
方案B:使用TortoiseGit自带PuTTY,私钥必须转为
.ppk格式。
方式一:OpenSSH模式(推荐,和Git‑Bash共用一套密钥,不用转换ppk)
步骤1:修改TortoiseGit的SSH客户端程序(关键设置)
-
在你的项目文件夹空白处右键 →
TortoiseGit→Settings; -
左侧选择
Network,SSH‑Client修改为Git安装目录下的ssh.exe,不要默认的TortoiseGitPlink.exe:C:\Program Files\Git\usr\bin\ssh.exe
步骤2:绑定远程仓库origin
- 左侧菜单:
Git→Remote; - Remote名称固定填写:
origin; - URL填入github的SSH地址:
git@github.com:xxxxxx9527/manager.git;Push URL保持空白;Putty Key不用填写(因为用OpenSSH); - 点击
Add New/Save→ 确定保存。
步骤3:设置Git全局用户名邮箱(和github注册邮箱一致)
在设置页面 Git‑User Info:
Name: xxxxxx9527
Email: 你的github注册邮箱
步骤4:首次推送(建立上游关联)
- 右键项目文件夹 → TortoiseGit‑Push;
- Local branch选择
main;Remote选origin;勾选Set upstream for local MAIN(设置上游追踪); - 第一次弹出确认服务器指纹,输入
yes;之后即可免密push、pull。
等价命令行:
git push -u origin main。
方式二:PuTTY模式(TortoiseGit默认模式,必须把私钥转为ppk文件)
- 打开
PuttyGen.exe(TortoiseGit安装目录bin文件夹);Load导入id_ed25519私钥,然后Save private key保存为id_ed25519.ppk; Settings‑Git‑Remote里面:URL填SSH地址,Putty‑Key选择刚才保存的.ppk文件;- Network页面保持默认
TortoiseGitPlink.exe;保存设置即可。
方式三:HTTPS模式(不用配置SSH密钥,但每次push要填写GitHub‑Token)
-
GitHub生成个人访问令牌Token:
头像 → Settings → Developer settings → Personal access tokens,勾选repo权限,生成40位Token字符串; -
Remote的URL填写:
https://xxxxx9527:你的token@github.com/xxxxxxx9527/manager.git
-
保存之后推送,就不会再弹出密码框。
后续日常操作(图形化按钮)
- 提交代码到本地仓库:右键 → Commit,填写备注;
- 推送到GitHub:右键 → TortoiseGit‑Push;
- 拉取云端更新:右键 → TortoiseGit‑Pull;
- 推送所有本地分支:
Git Sync,Push选项勾选All Branches。
常见报错处理
- 报错
Could not read from remote repository:- 情况1:Network里面SSH‑Client选错,要么用Git自带
ssh.exe,要么用plink搭配ppk密钥,二者不能混用; - 情况2:公钥没有正确粘贴进GitHub;执行
ssh -T git@github.com在Git‑Bash测试连通性。
- 情况1:Network里面SSH‑Client选错,要么用Git自带
- 已经配置过旧的远端地址,删除旧origin:
- 进入
Remote页面选中origin,Remove之后重新添加。
- 进入
- 第一次推送提示没有上游分支:Push界面勾选
Set upstream即可。
极简建议给你选择
- 优先选【方式一OpenSSH】,Git‑Bash和TortoiseGit共用一套密钥,后期切换命令行和图形化工具非常省心。
- 以后另一台新电脑:同样配置好SSH密钥,再配置TortoiseGit的ssh‑client,就可以clone和push代码。
补充:查看当前配置的远端地址(图形化查看)
Settings‑Git‑Remote页面可以查看origin地址;命令行查看:
bash
git remote -v