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
相关推荐
慧都小项19 小时前
MyEclipse Inline Diff 实用指南:逐处核对 AI 修改再提交
git·ai编程·myeclipse·java 代码审查·ai 代码修改
德育处主任21 小时前
让 Claude Code 在你睡觉时接着干活:tmux、权限策略与验收清单
git·ai编程·命令行
Funlang1 天前
在 Windows NT 3.5 上跑 Fun
windows
xx z2 天前
directx修复工具下载(DirectX Repair 增强版 使用说明)
windows·系统·工具·软件
xx z2 天前
pcl2启动器下载(Minecraft PCL2 启动器 最新版 安装与使用说明)
windows·游戏·工具·软件
凯瑟琳.奥古斯特2 天前
我开源了一个 Windows 截图取字工具:全局热键 + 离线 OCR + 标注打码,不上传任何数据
windows·ocr
Funlang3 天前
在 Windows 95 上跑 Fun
windows
为思念酝酿的痛3 天前
Git基本操作
git·github
ö Constancy3 天前
一台电脑的硬件组成与作用:按功能分类详解(Windows 与 Linux 视角)
linux·windows·电脑
雪落漂泊4 天前
Liunux进程(七):程序控制篇(中)
linux·运维·windows