1
2
3

git@github.com: Permission denied (publickey).
fatal: Could not read from remote repository.
Please make sure you have the correct access rights and the repository exists.

1
2
3

remote: error: File .docs/发展心理学 第三版 (林崇德) (Z-Library).pdf is 262.19 MB; this exceeds GitHub's file size limit of 100.00 MB
remote: error: File src/deskpet/node_modules/electron/dist/electron.exe is 168.10 MB; this exceeds GitHub's file size limit of 100.00 MB
remote: error: GH001: Large files detected. You may want to try Git Large File Storage - https://git-lfs.github.com.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 查看当前远程配置
git remote -v

# 切换远程仓库 URL 从 SSH 到 HTTPS
git remote set-url origin https://github.com/UcnacDx2/How-to-ADHD.git

# 验证切换结果
git remote -v

# 测试连接
git pull origin main
git push origin main

1
2
3

# 查看当前状态，发现大文件推送错误
git push origin main
# 错误信息显示具体的大文件路径和大小

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 将大文件目录添加到 .gitignore
echo .docs/ >> .gitignore
echo src/deskpet/node_modules/ >> .gitignore

# 从 Git 索引中移除大文件（保留本地文件）
git rm --cached -r .docs/
git rm --cached -r "src/deskpet/node_modules/"

# 提交变更
git add .gitignore
git commit -m "fix: 移除大文件并更新gitignore"

1
2
3
4

# 尝试推送仍然失败
git push origin main
# 错误：大文件仍在Git历史记录中
# 原因：git rm --cached 只移除当前索引，不清理历史记录

1
2
3

# 查看最近的提交，定位包含大文件的提交
git log --oneline -5
# 发现大文件在 50b5f54 和 f5fdbc9 等提交中

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 方案A: 使用 git filter-repo 清理历史（如果可用）
git filter-repo --path .docs/ --invert-paths
git filter-repo --path src/deskpet/node_modules/ --invert-paths

# 或方案B: 重置并重新提交有价值的文件
# 1. 备份有价值的文件
# 2. 重置到清洁状态
# 3. 重新添加并提交有价值的文件

# 最终推送成功
git push origin main

1
2
3
4
5
6
7

# SSH 连接测试成功输出
ssh -T git@github.com
# 输出: Hi UcnacDx2! You've successfully authenticated, but GitHub does not provide shell access.

# 推送成功无错误信息
git push origin main
# 输出: Everything up-to-date 或类似成功信息

1
2
3
4
5

# SSH 格式
git@github.com:UcnacDx2/How-to-ADHD.git

# HTTPS 格式  
https://github.com/UcnacDx2/How-to-ADHD.git

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

# 查看远程仓库配置
git remote -v

# 切换远程仓库 URL
git remote set-url origin <新URL>

# 测试 SSH 连接
ssh -T git@github.com

# 测试远程仓库连接
git ls-remote origin

### 大文件处理相关命令
```bash
# 基础大文件移除
git rm --cached -r <目录>  # 从索引移除但保留本地文件
echo <路径> >> .gitignore   # 添加到忽略列表
git add .gitignore         # 将 .gitignore 加入版本控制

# 检查Git历史中的大文件
git log --oneline -10      # 查看最近提交历史
git rev-list --objects --all | grep "$(git verify-pack -v .git/objects/pack/*.idx | sort -k 3 -nr | head -10)" # 找出最大的文件

# Git历史清理（高级操作，谨慎使用）
git filter-repo --path <文件路径> --invert-paths  # 从所有历史中移除指定路径
git filter-repo --strip-blobs-bigger-than 100M   # 移除所有大于100MB的文件

# 备份和恢复操作
git stash                  # 暂存当前更改
git stash pop             # 恢复暂存的更改
git reset --hard origin/main  # 重置到远程状态（危险操作）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

# 1. 创建备份分支
git branch backup-before-cleanup

# 2. 列出所有有价值的文件
git ls-files > valuable-files-list.txt

# 3. 使用工具清理历史（选择其一）
# 方案A: git filter-repo（推荐）
git filter-repo --path .docs/ --invert-paths
git filter-repo --path node_modules/ --invert-paths

# 方案B: 手动重置并重建
git reset --hard origin/main
# 然后重新添加有价值的文件

# 4. 强制推送（谨慎使用）
git push --force-with-lease origin main

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

### .gitignore 最佳实践
```gitignore
# 大文档和资料文件
.docs/
*.pdf
*.epub

# Node.js 依赖包
node_modules/
npm-debug.log*

# 操作系统文件
.DS_Store
Thumbs.db

# IDE 配置文件（可选）
.vscode/
.idea/