Gitee 与 GitHub：HTTPS/SSH 协议操作

一、前置准备：安装 Git 并初始化配置

在开始操作前，首先要确保本地已安装 Git，并完成基础的用户信息配置（这是 Git 提交记录的身份标识，必不可少）。

1. 安装 Git

Windows ：前往 Git 官方下载页下载安装包，按向导完成安装（建议勾选 "Git Bash Here" 方便右键打开命令行）。
Mac ：通过 Homebrew 安装 brew install git，或从 App Store 安装 Xcode（自带 Git）。
Linux ：Debian/Ubuntu 系统执行 sudo apt install git，CentOS/RHEL 系统执行 sudo yum install git。

2. 初始化 Git 全局配置

打开 Git Bash（Windows）或终端（Mac/Linux），执行以下命令配置用户名和邮箱（替换为你自己的信息）：

bash

运行

复制代码

# 配置用户名
git config --global user.name "你的用户名"
# 配置邮箱（建议与平台注册邮箱一致）
git config --global user.email "你的邮箱@example.com"

# 验证配置是否生效
git config --list

二、Gitee 操作指南

（一）Gitee + HTTPS 协议

HTTPS 是 Gitee 的默认协议，无需额外配置密钥，适合快速上手，核心是通过仓库的 HTTPS 地址进行克隆、推送和拉取。

1. 获取 Gitee 仓库的 HTTPS 地址

打开 Gitee 目标仓库页面，点击克隆 / 下载 ，选择HTTPS ，复制对应的地址（格式：https://gitee.com/用户名/仓库名.git）。

2. 克隆远程仓库到本地

bash

运行

复制代码

# 替换为你的 Gitee HTTPS 地址
git clone https://gitee.com/xxx/xxx.git

注意：首次克隆或推送时，Git 会弹出用户名和密码输入框，输入你的 Gitee 账号密码即可（若开启了两步验证，需使用访问令牌代替密码，令牌可在 Gitee 个人设置 → 私人令牌中生成）。

3. 本地修改后推送到 Gitee

bash

运行

复制代码

# 进入克隆的仓库目录
cd 仓库名

# 1. 暂存修改的文件
git add .

# 2. 提交到本地仓库
git commit -m "提交信息：如修复xxbug、新增xx功能"

# 3. 推送到 Gitee 远程仓库（首次推送建议指定分支，后续可简化）
git push origin master  # 或 main（Gitee 新版默认分支为 main）

4. 拉取 Gitee 远程最新代码

bash

运行

复制代码

# 直接拉取当前分支跟踪的远程代码
git pull

# 或指定远程和分支
git pull origin master

5. 解决 HTTPS 常见问题

SSL 证书验证失败 ：若出现 unable to get local issuer certificate 错误，可临时关闭 SSL 验证（仅应急用）：

bash

运行
复制代码
```
git config --global http.sslVerify false
```

每次推送都要输密码 ：可配置 Git 缓存凭证，避免重复输入：

bash

运行

复制代码

# 缓存凭证（默认15分钟，可修改超时时间）
git config --global credential.helper cache
# 永久缓存（Windows 推荐）
git config --global credential.helper wincred

（二）Gitee + SSH 协议

SSH 协议通过密钥对认证，无需每次输入密码，更适合长期使用。核心是生成 SSH 密钥并将公钥添加到 Gitee。

1. 生成 SSH 密钥对

在 Git Bash / 终端执行以下命令（邮箱建议与 Gitee 注册邮箱一致）：

bash

运行

复制代码

# 生成 ED25519 类型密钥（更安全，也可使用 rsa 类型：ssh-keygen -t rsa -b 4096 -C "你的邮箱"）
ssh-keygen -t ed25519 -C "你的邮箱@example.com"

执行后按回车默认生成密钥（无需设置密码，或按需设置），密钥文件会保存在 ~/.ssh 目录（Windows 为 C:\Users\你的用户名\.ssh），包含：

id_ed25519：私钥（重要，切勿泄露）；
id_ed25519.pub：公钥（需添加到 Gitee）。

2. 复制 SSH 公钥内容

bash

运行

复制代码

# Linux/Mac 系统
cat ~/.ssh/id_ed25519.pub

# Windows Git Bash 系统
cat ~/.ssh/id_ed25519.pub

# Windows PowerShell 系统
type $HOME\.ssh\id_ed25519.pub

复制输出的公钥内容（以 ssh-ed25519 开头，以你的邮箱结尾）。

3. 将公钥添加到 Gitee

登录 Gitee，进入个人设置 → SSH 公钥 → 添加公钥；
粘贴复制的公钥内容，自定义公钥名称（如 "本地电脑"），点击确定。

4. 测试 SSH 连接

bash

运行

复制代码

ssh -T git@gitee.com

若输出 Hi XXX! You've successfully authenticated, but Gitee does not provide shell access.，说明 SSH 连接成功。

5. 使用 SSH 地址操作仓库

克隆仓库 ：

bash

运行

复制代码

# 替换为你的 Gitee SSH 地址（格式：git@gitee.com:用户名/仓库名.git）
git clone git@gitee.com:xxx/xxx.git

推送 / 拉取代码 ：与 HTTPS 协议操作一致，无需输入密码，直接执行 git push/git pull 即可。

三、GitHub 操作指南

GitHub 的操作流程与 Gitee 基本一致，但由于网络环境差异，SSH 协议需注意端口问题，HTTPS 需处理 SSL 证书问题。

（一）GitHub + HTTPS 协议

1. 获取 GitHub 仓库的 HTTPS 地址

打开 GitHub 目标仓库页面，点击Code ，复制 HTTPS 地址（格式：https://github.com/用户名/仓库名.git）。

2. 克隆远程仓库到本地

bash

运行

复制代码

git clone https://github.com/xxx/xxx.git

注意：首次认证时，输入 GitHub 账号密码（若开启两步验证，需使用个人访问令牌（PAT） 代替密码，令牌可在 GitHub → Settings → Developer settings → Personal access tokens 中生成）。

3. 推送 / 拉取代码

bash

运行

复制代码

# 暂存、提交（与 Gitee 一致）
git add .
git commit -m "提交信息"

# 推送到 GitHub
git push origin master  # 或 main（GitHub 新版默认分支为 main）

# 拉取远程代码
git pull

4. 解决 GitHub HTTPS 常见问题

SSL 证书验证失败 ：同 Gitee，可临时关闭 SSL 验证：

bash

运行
复制代码
```
git config --global http.sslVerify false
```
网络卡顿 / 连接超时：可配置 GitHub 镜像或代理（需确保代理可用）。

（二）GitHub + SSH 协议

GitHub 的 SSH 操作与 Gitee 类似，但部分网络环境会拦截 22 端口，需改用 443 端口（GitHub 提供了备用的 SSH 端口）。

1. 生成 SSH 密钥对（同 Gitee 步骤）

bash

运行

复制代码

ssh-keygen -t ed25519 -C "你的邮箱@example.com"

2. 复制 SSH 公钥并添加到 GitHub

复制公钥内容（cat ~/.ssh/id_ed25519.pub）；
登录 GitHub，进入Settings → SSH and GPG keys → New SSH key；
粘贴公钥内容，自定义名称，点击Add SSH key。

3. 配置 SSH 端口（解决 22 端口被拦截问题）

若直接连接 GitHub 的 22 端口出现 Connection refused 错误，需修改 SSH 配置：

打开 / 创建 SSH 配置文件： bash

运行
复制代码
```
vi ~/.ssh/config
```

添加以下配置： bash

运行

复制代码

Host github.com
  Hostname ssh.github.com
  Port 443
  User git

保存退出（vi 编辑器按 Esc，输入 :wq 回车）。

4. 测试 SSH 连接

bash

运行

复制代码

ssh -T git@github.com

若输出 Hi XXX! You've successfully authenticated, but GitHub does not provide shell access.，说明连接成功。

5. 使用 SSH 地址操作仓库

克隆仓库 ：

bash

运行

复制代码

# 替换为你的 GitHub SSH 地址（格式：git@github.com:用户名/仓库名.git）
git clone git@github.com:xxx/xxx.git

推送 / 拉取代码 ：直接执行 git push/git pull，无需输入密码。