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
相关推荐
趣味科技4 小时前
记录修复EAGET忆捷移动硬盘损坏
windows·数据分析·硬件工程
月落归舟4 小时前
Git 新手入门指南
git
达达车5 小时前
git使用技巧记录
git·使用技巧·版本管理
我命由我123455 小时前
Java 开发 - List subList 方法
java·windows·操作系统·list·intellij-idea·idea·intellij idea
吃辣我第一5 小时前
监听SHP目录自动注册SuperMap iServer地图服务(Windows版)
windows·iserver·shapefile
程序员老陆6 小时前
FFmpeg6 在 Windows 打开麦克风并录成 PCM:不走 Qt Multimedia,也不碰 WASAPI
windows·ffmpeg·音视频·pcm
Simon—欧阳6 小时前
Git使用心得&理解
git
chushiyunen7 小时前
神雕武功排名
windows
酩酊仙人7 小时前
Windows Server部署django
windows·django·sqlite
AI行业学习7 小时前
Claude Code + cc-switch + Git + Node.js 一站式完整安装配置教程【8.3】
git·python·安全·前端框架·node.js·html·notepad++