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. 在你的项目文件夹空白处右键 → TortoiseGit → Settings;

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

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

步骤2:绑定远程仓库origin

  1. 左侧菜单:Git → Remote;
  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
相关推荐
搬砖的小码农_Sky7 小时前
AI Agent:如何处理Claude Code 最近版本(2026年更新)引入的模型上下文限制
人工智能·windows·ai·ai编程
kakakahahahaha7 小时前
Windows C盘临时文件清理:%temp%、Windows Temp、Prefetch、Windows.old与hiberfil.sys处理指南
c语言·开发语言·windows
山岚的运维笔记10 小时前
ComfyUI NVIDIA安装教程:官方便携版下载+run_nvidia_gpu.bat启动,8G显存Windows实操
运维·服务器·windows·笔记·prompt·aigc·comfyui
kakakahahahaha12 小时前
LoadLibrary failed with error 87 排查:ERROR_INVALID_PARAMETER、DLL路径、架构与显卡驱动
windows·电脑·笔记本电脑·nvidia·软件需求
百事牛科技14 小时前
7Z分卷文件怎么打开?7-Zip解压方法详解
windows·7-zip
寺中人15 小时前
Xshell 完全入门指南:从安装到实战,远程连接+文件传输+会话管理全拆解
git·ssh·github·php·远程连接·xshell·运维工具
酬谢神明则必安16 小时前
git学习记录01
linux·git·学习
lingchen190616 小时前
版本控制 Git源代码项目管理
git
虫无涯17 小时前
Coverity 如何结合 GJB8114-2013使用?
git·单元测试·嵌入式测试·coverity·静态扫描
2301_7893804918 小时前
【踩坑记录】Windows资源管理器无限重启,改注册表、看日志
windows·经验分享·笔记