Git远程仓库实操笔记Gitee GitHub 双平台 HTTPS/SSH 全流程整理了最近实操踩坑的 Git 远程仓库配置覆盖国内 Gitee 和 GitHub 两个主流平台分别走 HTTPS 和 SSH 两种连接方式。整体逻辑大同小异但分支命名、密钥类型、网络问题这些细节坑不少统一记录下来方便复盘和查阅。前置本地 Git 基础配置在操作远程仓库之前先确保本地 Git 环境已经完成基础初始化这一步是所有操作的前提新建项目空文件夹右键打开 Git Bash 窗口初始化本地 Git 仓库gitinit全局用户配置本机只需要配置一次所有仓库共用gitconfig--globaluser.name你的用户名gitconfig--globaluser.email你的邮箱地址不带--global就是仅当前仓库生效学习阶段用全局配置即可。一、Gitee 远程仓库配置Gitee 是国内代码托管平台网络稳定访问流畅非常适合日常学习和个人项目托管。1.1 HTTPS 连接方式HTTPS 是最容易上手的方式复制仓库地址直接关联即可缺点是每次推拉代码都需要身份校验频繁操作会稍显繁琐。操作步骤Gitee 端新建仓库登录 Gitee 后右上角新建仓库填写仓库名称建议勾选初始化 README、.gitignore 文件创建完成后复制仓库的 HTTPS 地址格式为https://gitee.com/用户名/仓库名.git本地关联远程仓库在项目文件夹的 Git Bash 中执行origin是远程仓库的默认别名gitremoteaddorigin https://gitee.com/XS030106/my-test01.git拉取远程仓库内容先把远程的 README、.gitignore 拉取到本地避免后续推送出现冲突gitpull origin master首次操作会弹出登录窗口输入 Gitee 账号密码完成认证即可。本地提交并推送代码新建一个测试文件完成本地提交后推送到远程仓库# 新建测试文件示例vitest.txt# 添加文件到暂存区gitadd.# 提交到本地仓库gitcommit-m新增测试文件test.txt# 推送到远程master分支gitpush origin master刷新 Gitee 仓库页面就能看到推送成功的文件HTTPS 方式配置完成。踩坑备注执行git add .出现LF will be replaced by CRLF警告这是 Windows 与 Linux 系统换行符差异导致不影响正常使用如需统一可执行git config --global core.autocrlf true。仓库地址注意大小写Gitee 地址对大小写敏感写错会提示仓库不存在。1.2 SSH 连接方式推荐日常使用SSH 通过公钥-私钥对进行身份认证配置完成后免密推拉代码是长期开发的首选方式。Gitee 的 SSH 公钥分为两种账户公钥和仓库部署公钥作用范围与权限不同。1.2.1 账户公钥全仓库读写权限与个人账号绑定配置后对该账号下所有仓库都拥有读写权限最适合个人日常开发使用。操作步骤本地生成 SSH 密钥对# -t 指定加密算法ed25519 轻量安全是目前最推荐的算法# -C 为备注信息方便识别密钥用途ssh-keygen-ted25519-CGitee SSH Key一路回车即可密钥默认保存在~/.ssh/目录下密码留空即可实现免密操作。查看生成的密钥文件ls~/.ssh/输出的两个核心文件id_ed25519私钥绝对不能外传id_ed25519.pub公钥需要粘贴到 Gitee 后台读取公钥内容并复制cat~/.ssh/id_ed25519.pub复制输出的全部内容从开头的ssh-ed25519一直到末尾的备注信息。Gitee 后台添加公钥路径个人设置 → 安全设置 → SSH 公钥 → 添加公钥标题可自定义比如“个人笔记本”公钥内容粘贴刚才复制的字符串保存即可。测试连接是否成功ssh-Tgitgitee.com首次连接输入yes信任主机出现以下提示即为配置成功Hi 用户名! Youve successfully authenticated, but GITEE.COM does not provide shell access.后半句是正常提示Gitee 不提供 SSH 终端登录权限不影响代码推拉操作。1.2.2 仓库部署公钥单仓库只读权限只针对单个指定仓库生效默认只有拉取权限、无法推送一般用于生产服务器部署代码防止误操作修改线上代码。操作步骤本地生成密钥的步骤与账户公钥完全一致进入对应仓库页面管理 → 部署公钥管理 → 添加部署公钥粘贴公钥内容保存测试连接方式同上1.2.3 两种公钥核心区别公钥类型作用范围权限适用场景账户公钥账号下所有仓库可读可写个人日常开发、多项目维护部署公钥单个指定仓库默认只读服务器部署、CI/CD 自动拉取二、GitHub 远程仓库配置GitHub 是全球最大的代码托管平台整体逻辑与 Gitee 基本一致但有两个特殊点国内网络访问不稳定、HTTPS 方式必须使用令牌登录。2.1 HTTPS 连接方式GitHub 目前已不支持账号密码直接登录 HTTPS必须使用个人访问令牌PAT作为密码进行认证。操作步骤GitHub 新建仓库右上角New repository填写仓库名称选择公开/私有属性按需勾选 README 和 .gitignore创建完成后复制 HTTPS 地址格式为https://github.com/用户名/仓库名.git本地关联远程仓库gitremoteaddorigin https://github.com/Xie724/myTest01.git生成 Personal Access TokenPAT路径右上角头像 → Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token (classic)Note 填写备注比如“Windows 本地开发”Expiration 选择令牌过期时间学习使用可设置较长有效期必须勾选repo权限其他权限按需选择生成后立即复制令牌页面关闭后无法再次查看务必保存好拉取远程代码# GitHub 新建仓库默认主分支是 main不是 mastergitpull origin main弹出登录窗口时用户名填写 GitHub 账号密码粘贴刚才生成的 PAT 令牌。踩坑备注国内网络经常出现Failed to connect to github.com:443连接超时属于网络环境问题无代理的情况下不推荐日常使用 GitHub HTTPS。令牌丢失只能重新生成无法找回原令牌。2.2 SSH 连接方式逻辑与 Gitee SSH 完全相同仅公钥粘贴位置不同配合网络代理使用时稳定性远好于 HTTPS。操作步骤生成 GitHub 专属密钥可选如果希望 Gitee 和 GitHub 使用独立密钥生成时指定文件名即可ssh-keygen-ted25519-CGitHub SSH Key-f~/.ssh/id_ed25519_github懒人方案直接使用同一对公钥同时粘贴到 Gitee 和 GitHub 后台无需额外配置。GitHub 后台添加公钥路径右上角头像 → Settings → SSH and GPG keys → New SSH keyTitle 填写备注Key type 选择Authentication keyKey 栏粘贴公钥内容保存即可测试连接ssh-Tgitgithub.com出现Hi 用户名! Youve successfully authenticated即为配置成功。进阶双平台多密钥共存配置如果 Gitee 和 GitHub 使用了不同的密钥需要通过 SSH config 文件实现自动分流避免密钥串号进入 ssh 目录新建无后缀的 config 文件cd~/.sshnanoconfig粘贴以下配置内容# Gitee 配置 Host gitee.com HostName gitee.com User git IdentityFile ~/.ssh/id_ed25519_gitee IdentitiesOnly yes # GitHub 配置 Host github.com HostName github.com User git IdentityFile ~/.ssh/id_ed25519_github IdentitiesOnly yes保存退出后SSH 连接会自动匹配对应平台的密钥。三、高频踩坑与核心总结3.1 master 还是 main分支名踩坑本地git init初始化的仓库默认分支名叫masterGitee、GitHub 新建的线上仓库默认主分支都叫main报错couldnt find remote ref master几乎都是因为远程分支是 main拉取/推送时写对分支名即可本地分支改名命令git branch -m master main本地 master 推送到远程 maingit push -u origin master:main3.2 远程仓库常用命令# 查看当前远程地址gitremote-v# 修改远程仓库地址gitremote set-url origin 新地址# 删除远程仓库关联gitremote remove origin3.3 HTTPS vs SSH 怎么选对比项HTTPSSSH上手难度简单复制地址即用稍复杂需要生成密钥对认证方式账号密码/令牌每次操作校验密钥对认证配置后全程免密网络表现GitHub 极易超时体验差相对稳定受网络波动影响小适用场景临时拉取公开仓库长期开发、日常代码推送3.4 个人使用建议国内日常学习、项目托管优先选择Gitee SSH网络稳定体验流畅需要同步 GitHub配置双密钥本地仓库可同时添加两个远程源实现一键同步推送单个仓库尽量统一使用一种协议避免 HTTPS 和 SSH 混用导致凭证混乱