mirror of
https://github.com/handsomezhuzhu/QQuiz.git
synced 2026-02-20 20:10:14 +00:00
handsomezhuzhu
6da18ea7ab
## 新增 - GITHUB_PUSH_GUIDE.md: 完整的 GitHub 推送指南 - Personal Access Token 认证 - SSH Key 配置 - 问题排查 - push_to_github.bat: 自动化推送脚本 - 一键提交并推送 - 友好的交互提示 🚀 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
215 lines
3.9 KiB
Markdown
215 lines
3.9 KiB
Markdown
# GitHub 推送指南
|
||
|
||
## 方式一：使用 Personal Access Token（推荐）
|
||
|
||
GitHub 已不再支持密码认证，需要使用 Personal Access Token (PAT)。
|
||
|
||
### 步骤 1：创建 GitHub Personal Access Token
|
||
|
||
1. **访问 GitHub 设置**
|
||
- 登录 GitHub: https://github.com
|
||
- 点击右上角头像 → Settings
|
||
- 左侧菜单选择 **Developer settings**
|
||
- 选择 **Personal access tokens** → **Tokens (classic)**
|
||
- 点击 **Generate new token** → **Generate new token (classic)**
|
||
|
||
2. **配置 Token**
|
||
- Note: `QQuiz Deploy`
|
||
- Expiration: 选择过期时间（建议 90 days 或 No expiration）
|
||
- 勾选权限：
|
||
- ✅ **repo** (完整仓库访问权限)
|
||
- 点击 **Generate token**
|
||
|
||
3. **保存 Token**
|
||
- ⚠️ **重要**：立即复制生成的 token，它只会显示一次！
|
||
- 格式类似：`ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`
|
||
|
||
### 步骤 2：配置 Git 凭据
|
||
|
||
**方式 A：使用 Git Credential Manager（推荐）**
|
||
|
||
```powershell
|
||
# 配置凭据存储
|
||
git config --global credential.helper manager-core
|
||
|
||
# 首次推送时会弹出窗口，输入：
|
||
# Username: handsomezhuzhu
|
||
# Password: 粘贴你的 Personal Access Token
|
||
```
|
||
|
||
**方式 B：直接在 URL 中使用 Token**
|
||
|
||
```powershell
|
||
cd E:\QQuiz
|
||
|
||
# 移除旧的 remote
|
||
git remote remove origin
|
||
|
||
# 添加包含 token 的 remote
|
||
git remote add origin https://ghp_YOUR_TOKEN_HERE@github.com/handsomezhuzhu/QQuiz.git
|
||
|
||
# 推送
|
||
git push -u origin main
|
||
```
|
||
|
||
将 `ghp_YOUR_TOKEN_HERE` 替换为你的实际 token。
|
||
|
||
### 步骤 3：推送到 GitHub
|
||
|
||
```powershell
|
||
cd E:\QQuiz
|
||
|
||
# 推送代码
|
||
git push -u origin main
|
||
```
|
||
|
||
如果使用方式 A，会弹出认证窗口，输入：
|
||
- **Username**: `handsomezhuzhu`
|
||
- **Password**: 粘贴你的 Personal Access Token
|
||
|
||
---
|
||
|
||
## 方式二：使用 SSH Key（适合频繁推送）
|
||
|
||
### 步骤 1：生成 SSH Key
|
||
|
||
```powershell
|
||
# 生成新的 SSH Key
|
||
ssh-keygen -t ed25519 -C "your_email@example.com"
|
||
|
||
# 按提示操作：
|
||
# - 文件位置：直接回车（使用默认）
|
||
# - 密码：可以留空或设置密码
|
||
```
|
||
|
||
### 步骤 2：添加 SSH Key 到 GitHub
|
||
|
||
```powershell
|
||
# 查看公钥
|
||
cat ~/.ssh/id_ed25519.pub
|
||
|
||
# 或在 Windows 上
|
||
type %USERPROFILE%\.ssh\id_ed25519.pub
|
||
```
|
||
|
||
复制输出的公钥（以 `ssh-ed25519` 开头）
|
||
|
||
1. 访问 GitHub Settings → SSH and GPG keys
|
||
2. 点击 **New SSH key**
|
||
3. Title: `QQuiz Dev PC`
|
||
4. Key: 粘贴公钥
|
||
5. 点击 **Add SSH key**
|
||
|
||
### 步骤 3：修改 Remote 为 SSH
|
||
|
||
```powershell
|
||
cd E:\QQuiz
|
||
|
||
# 移除旧的 HTTPS remote
|
||
git remote remove origin
|
||
|
||
# 添加 SSH remote
|
||
git remote add origin git@github.com:handsomezhuzhu/QQuiz.git
|
||
|
||
# 推送
|
||
git push -u origin main
|
||
```
|
||
|
||
---
|
||
|
||
## 快速推送脚本
|
||
|
||
创建 `push_to_github.bat`：
|
||
|
||
```batch
|
||
@echo off
|
||
echo Pushing to GitHub...
|
||
|
||
cd /d "%~dp0"
|
||
|
||
git add .
|
||
git status
|
||
|
||
echo.
|
||
set /p commit_msg="Enter commit message: "
|
||
|
||
git commit -m "%commit_msg%"
|
||
git push origin main
|
||
|
||
echo.
|
||
echo Done!
|
||
pause
|
||
```
|
||
|
||
---
|
||
|
||
## 验证推送成功
|
||
|
||
推送成功后：
|
||
|
||
1. 访问：https://github.com/handsomezhuzhu/QQuiz
|
||
2. 应该能看到所有代码文件
|
||
3. 查看 Commits 历史
|
||
|
||
---
|
||
|
||
## 常见问题
|
||
|
||
### Q1: 推送失败 - Authentication failed
|
||
|
||
**原因**：密码认证已被 GitHub 禁用
|
||
|
||
**解决**：使用 Personal Access Token 或 SSH Key
|
||
|
||
### Q2: 推送被拒绝 - Updates were rejected
|
||
|
||
```
|
||
! [rejected] main -> main (fetch first)
|
||
```
|
||
|
||
**解决**：
|
||
```powershell
|
||
# 拉取远程更改
|
||
git pull origin main --allow-unrelated-histories
|
||
|
||
# 再次推送
|
||
git push -u origin main
|
||
```
|
||
|
||
### Q3: 推送很慢
|
||
|
||
**解决**：配置代理（如果使用 VPN）
|
||
```powershell
|
||
# 设置 HTTP 代理
|
||
git config --global http.proxy http://127.0.0.1:7890
|
||
|
||
# 取消代理
|
||
git config --global --unset http.proxy
|
||
```
|
||
|
||
---
|
||
|
||
## 后续推送
|
||
|
||
首次推送成功后，以后只需：
|
||
|
||
```powershell
|
||
cd E:\QQuiz
|
||
|
||
# 查看更改
|
||
git status
|
||
|
||
# 添加文件
|
||
git add .
|
||
|
||
# 提交
|
||
git commit -m "your commit message"
|
||
|
||
# 推送
|
||
git push
|
||
```
|
||
|
||
---
|
||
|
||
祝你推送成功！🚀
|