[Git 实战] 学习笔记：从生成 SSH 密钥到解决 TortoiseGit 推送报错全指南-云帆数科

核心结论TL;DR首选 Ed25519放弃传统的 RSA 算法使用更安全、更简短的ed25519算法生成 SSH 密钥配置时提示保存路径和密码一律直接按回车。图形化工具排雷TortoiseGit小乌龟默认的 PuTTY 客户端与 Git 原生的 OpenSSH 密钥不兼容遇到publickey报错需在设置中将 SSH Client 切换为 Git 自带的ssh.exe。Clone 保命法则执行git clone遇到“目标路径非空”报错时Git 会自动中止绝不会删除你的本地文件。需根据情况选择清空目录、备份合并或直接git pull。仓库防污染必须在项目根目录配置.gitignore文件排除虚拟环境.venv和 IDE 配置.idea防止仓库体积臃肿。一、 SSH 密钥配置Ed25519 最佳实践在使用 Git 时SSH 协议可以让我们免去每次推送都要输入账号密码的烦恼。目前Ed25519 算法因其安全性高、生成速度快已成为 GitHub 和 Gitee 官方推荐的首选。1.检查是否已有SSH密钥打开 Git Bash输入ls -al ~/.ssh。如果看到id_rsa.pub或id_ed25519.pub这样的文件说明已有密钥可以跳到第3步。2. 生成密钥打开 Git Bash输入以下命令替换为你的邮箱ssh-keygen -t ed25519 -C 你的Gitee/GitHub邮箱⚠️ 排雷时刻提示Enter file in which to save the key保存路径直接按回车千万别填仓库地址。提示Enter passphrase设置密码直接按两次回车留空以后拉取代码无需输密码。3. 复制并添加公钥执行命令查看并复制公钥内容cat ~/.ssh/id_ed25519.pub终端会输出一长串以ssh-ed25519开头的字符完整复制。登录 Gitee/GitHub进入设置 - SSH 公钥粘贴并保存。4. 复制并添加公钥登录 Gitee 网站。点击右上角你的头像选择设置。在左侧菜单栏找到并点击SSH 公钥。在“添加公钥”区域标题随便填比如“我的电脑”公钥框里粘贴你刚才复制的那一大段字符串。点击确定此时可能需要你输入 Gitee 的登录密码来确认5. 验证连接在终端输入ssh -T gitgitee.com # 或 gitgithub.com如果提示Hi 你的用户名! Youve successfully authenticated, but GITEE.COM does not provide shell access.或者询问你是否继续连接输入yes就说明配置成功了二、 TortoiseGit 图形化工具的终极排雷很多开发者习惯用 TortoiseGit小乌龟右键菜单操作但极易遇到这个经典报错No supported authentication methods available (server sent: publickey)原因TortoiseGit 默认使用自己的 SSH 客户端PuTTY而我们刚生成的是 OpenSSH 格式的密钥两者不兼容。解决步骤右键桌面空白处 -TortoiseGit-Settings。左侧选择Network。将右侧的SSH Client路径修改为 Git 自带的客户端C:\Program Files\Git\usr\bin\ssh.exe点击 Apply 保存。再次推送丝滑通过。⚠️ 三、踩坑排查排雷Clone 遇到目录非空如果你在已存在的文件夹里直接执行git cloneGit 会直接报错并中止操作fatal: destination path ... already exists and is not an empty directory.别慌你的文件绝对不会丢失根据你的情况选择以下方案情况 A文件夹里全是垃圾 / 上次失败的残留如果你确定里面的文件不需要了直接手动删除该文件夹然后重新执行你的git clone命令。情况 B里面有本地重要代码需要合并千万别直接用 clone 覆盖先把本地文件夹重命名备份如_backup。正常执行git clone下载全新仓库。把备份文件夹里的重要代码手动复制到新克隆的仓库里。情况 C这个文件夹本身就是个 Git 仓库有.git隐藏文件夹如果你之前就克隆过只是重装了系统根本不需要重新 clone在终端cd进入该文件夹。检查远程连接是否还在git remote -v。如果能看到origin地址直接拉取最新代码即可git pull origin master # 或 git pull origin main如果提示没有权限只需按第一步重新配置一次 SSH 公钥即可。️ 四、仓库防污染.gitignore 的重要性在提交代码前如果误将虚拟环境.venv和 IDE 配置.idea提交会导致仓库极其臃肿且在不同电脑间引发路径冲突。在项目根目录新建.gitignore文件填入以下内容# 忽略虚拟环境 .venv/ venv/ # 忽略 IDE 配置 .idea/ .vscode/ # 忽略 Python 缓存 __pycache__/ *.pyc # 忽略环境变量保护 API Key .env如果已经误提交在终端执行git rm -r --cached .venv .idea清除版本控制缓存不会删除本地文件然后重新 Commit。

企业数字化 ERP 产品动态

相关推荐

CISP-PTE 爆破篇

本文为 CISP-PTE 备考学习笔记，所有操作仅在官方授权靶场、本地自建靶场环境完成。文中 Payload 仅用于原理学习、靶场练习。严禁直接套用在任何未授权公网业务系统。未经授权对网站进行注入、扫描属于违法行为，请遵守《网络安全法》。本文目的&#x… · 2026/11/4 5:44:22

【研发类-后端开发Skills】azure-communication-common-java 技能

Azure Communication Services Java通用工具。在使用CommunicationTokenCredential、用户标识符、令牌刷新或跨ACS服务共享身份验证时使用。技能概述 azure-communication-common-java 技能是Azure Communication Services的共享身份验证工具和数据结构库。它提供了令牌凭据… · 2026/11/6 23:11:09

AI前沿 | 2026年10月29日：Genie 4 世界模型 + 实时音频 + 混合世界模型

AI前沿 | 2026年10月29日：Genie 4 世界模型实时音频混合世界模型 📖 首屏导读本教程配套付费专栏：《大模型工程师修炼手记》 19.9 元（AI 编程 Agent 实战本文同主题系统课程） 《AI时代程序员的自我提升》 49.… · 2026/11/3 15:49:05

沙田电工证哪里年审？电子证书怎么操作最省事

沙田电工证哪里年审？电子证书怎么操作最省事找工作没证寸步难行，尤其是特种作业证，像电工证这类证书直接关系到能不能上岗。很多人一着急就乱报，结果证件不合规，耽误了时间又白花钱。现在很多人开始用电子证书，既方便又快捷，但关键问题是——… · 2026/11/7 15:17:27

鹰潭余江区电工证内部消息：怕考不过白交培训费？这几点你必须知道

鹰潭余江区电工证内部消息：怕考不过白交培训费？这几点你必须知道怕考不过白交培训费？别慌，内部消息来了！在鹰潭余江区，电工证考试是很多从业者绕不开的一道关卡，尤其是三门峡地区的中小施工企业负责人，对电工证的含金量和考试通过率都格外关注。… · 2026/11/7 15:17:27

电工证考试模拟软件2026河南最新政策下怎么考？企业负责人必看

电工证考试模拟软件2026河南最新政策下怎么考？企业负责人必看现在找工作，特种作业证几乎是门槛，特别是电工证，没有它连面试机会都可能没有。河南的2026年最新政策对电工证的报考条件、考试流程、复审要求等都做了调整，企业负责人如果不了解这些… · 2026/11/7 15:17:27

西安考电工证在啥地方良心建议：学历不高怕报不上名？别慌，手把手教你搞懂

西安考电工证在啥地方良心建议：学历不高怕报不上名？别慌，手把手教你搞懂你是不是也担心自己学历不高，连个电工证都报不上名？其实，这种想法大可不必有。不管你是初中、高中还是大专毕业，只要符合年龄、身体健康等基本条件，都能报考电工证。今天就从… · 2026/11/7 15:17:27

罗定去哪里考电工证良心建议，外省证能不能转过来

罗定去哪里考电工证良心建议，外省证能不能转过来之前考的证在外省能不能转过来？这个问题我听太多人问了，特别是那些在外地工作、想回罗定发展的朋友们，担心自己手里的电工证是不是“废纸一张”。今天就从罗定去哪里考电工证这个角度，给大伙儿一个… · 2026/11/7 15:17:27

电工特种作业操作证章通过率揭秘，新乡从业者如何避坑

电工特种作业操作证章通过率揭秘，新乡从业者如何避坑不知道去哪报名怕被中介坑？你不是一个人。随着电力施工、建筑安装等行业对特种作业人员的资质要求不断提高，电工特种作业操作证章… · 2026/11/7 15:16:26

双极步进电机控制实战：DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/7 11:25:08