TortoiseGit推送到远端,如何配置

整体分两大方式:SSH(免密,优先推荐适配你的github)、HTTPS‑Token方式,分远端GitHub网页配置 + TortoiseGit本地配置两步完成。

前置准备(GitHub网页配置远端仓库)

  1. 登录GitHub网站,新建仓库(New repository);仓库名和本地项目一致(manager),不要勾选Add a README.md(避免首次推送冲突),创建仓库后复制SSH地址:

    git@github.com:yuepei9527/manager.git

  2. 把公钥配置到GitHub:

    • 你之前Git‑Bash生成id_ed25519.pub里面全部内容复制;
    • GitHub头像 → Settings → SSH and GPG keys → New SSH key,粘贴公钥保存。

注意:TortoiseGit有两种SSH模式:

方案A:沿用Git‑Bash的OpenSSH密钥(推荐,不用转换ppk文件);

方案B:使用TortoiseGit自带PuTTY,私钥必须转为.ppk格式。


方式一:OpenSSH模式(推荐,和Git‑Bash共用一套密钥,不用转换ppk)

步骤1:修改TortoiseGit的SSH客户端程序(关键设置)

  1. 在你的项目文件夹空白处右键 → TortoiseGitSettings

  2. 左侧选择 Network,SSH‑Client修改为Git安装目录下的ssh.exe,不要默认的TortoiseGitPlink.exe

    C:\Program Files\Git\usr\bin\ssh.exe

步骤2:绑定远程仓库origin

  1. 左侧菜单:GitRemote
  2. Remote名称固定填写:origin
  3. URL填入github的SSH地址:git@github.com:xxxxxx9527/manager.git;Push URL保持空白;Putty Key不用填写(因为用OpenSSH);
  4. 点击Add New/Save → 确定保存。

步骤3:设置Git全局用户名邮箱(和github注册邮箱一致)

在设置页面 Git‑User Info

复制代码
Name: xxxxxx9527
Email: 你的github注册邮箱

步骤4:首次推送(建立上游关联)

  1. 右键项目文件夹 → TortoiseGit‑Push;
  2. Local branch选择main;Remote选origin;勾选 Set upstream for local MAIN(设置上游追踪);
  3. 第一次弹出确认服务器指纹,输入yes;之后即可免密push、pull。

等价命令行:git push -u origin main


方式二:PuTTY模式(TortoiseGit默认模式,必须把私钥转为ppk文件)

  1. 打开PuttyGen.exe(TortoiseGit安装目录bin文件夹);Load导入id_ed25519私钥,然后Save private key保存为id_ed25519.ppk
  2. Settings‑Git‑Remote里面:URL填SSH地址,Putty‑Key选择刚才保存的.ppk文件;
  3. Network页面保持默认TortoiseGitPlink.exe;保存设置即可。

方式三:HTTPS模式(不用配置SSH密钥,但每次push要填写GitHub‑Token)

  1. GitHub生成个人访问令牌Token:
    头像 → Settings → Developer settings → Personal access tokens,勾选repo权限,生成40位Token字符串;

  2. Remote的URL填写:

    https://xxxxx9527:你的token@github.com/xxxxxxx9527/manager.git

  3. 保存之后推送,就不会再弹出密码框。


后续日常操作(图形化按钮)

  1. 提交代码到本地仓库:右键 → Commit,填写备注;
  2. 推送到GitHub:右键 → TortoiseGit‑Push;
  3. 拉取云端更新:右键 → TortoiseGit‑Pull;
  4. 推送所有本地分支:Git Sync,Push选项勾选All Branches。

常见报错处理

  1. 报错Could not read from remote repository
    • 情况1:Network里面SSH‑Client选错,要么用Git自带ssh.exe,要么用plink搭配ppk密钥,二者不能混用;
    • 情况2:公钥没有正确粘贴进GitHub;执行ssh -T git@github.com在Git‑Bash测试连通性。
  2. 已经配置过旧的远端地址,删除旧origin:
    • 进入Remote页面选中origin,Remove之后重新添加。
  3. 第一次推送提示没有上游分支:Push界面勾选Set upstream即可。

极简建议给你选择

  1. 优先选【方式一OpenSSH】,Git‑Bash和TortoiseGit共用一套密钥,后期切换命令行和图形化工具非常省心。
  2. 以后另一台新电脑:同样配置好SSH密钥,再配置TortoiseGit的ssh‑client,就可以clone和push代码。

补充:查看当前配置的远端地址(图形化查看)

Settings‑Git‑Remote页面可以查看origin地址;命令行查看:

bash 复制代码
git remote -v
相关推荐
2601_9623649712 小时前
Windows Hello VS 传统密码:身份认证安全层级全面对比分析
windows·安全·电脑
Imagine Miracle16 小时前
【WSL】让WSL2后台持久运行不自动关闭的解决方案
linux·windows·wsl
啦啦啦~~~22216 小时前
经典小游X,免费刺激,可离线使用!
windows·游戏·开源软件
月走乂山18 小时前
Windows提示调制解调器报错、同交换机其他电脑正常、远程能连但浏览器打不开——本机DNS配置问题排查
windows·dns·故障排查·网络故障·网络诊断
Hey_Coder19 小时前
【Git 常用命令速查表(按功能分类)】
git·git基础命令·git命令速查表·git 常用命令
衔烛之龙120 小时前
Windows x64 构建 liboqs-java教程
java·windows·python
colman wang21 小时前
Git指令(Mac)
git·macos
阿豪只会阿巴1 天前
两小时快速入门 FastAPI--第二回
windows·python·fastapi
cyforkk1 天前
Git 合并分支提示 Already up to date 的真实原因
git