本地代码文件夹上传至 GitHub 完整指南与常用命令

五、常见问题排查

1. 推送失败：分支冲突

若远程已有文件而本地无，或历史不一致：

git pull origin main --allow-unrelated-histories
git push origin main

2. 忽略特定文件

在项目根目录创建 .gitignore 文件，内容示例：

node_modules/
dist/
.idea/
*.log

提交更新：

git add .
git commit -m "add gitignore"
git push

3. HTTPS 连接重置/超时

报错 Recv failure: Connection was reset 或 Failed to connect 通常由网络或 SSL 配置引起。

方案 A：切换 SSL 后端（推荐 Windows）

git config --global http.sslBackend schannel
git push -u origin main

方案 B：关闭 HTTP/2

git config --global http.version HTTP/1.1
git push -u origin main

方案 C：配置代理（如有 VPN/代理软件）

检查当前代理配置：

git config --global --get http.proxy
git config --global --get https.proxy

若有输出，清除代理：

git config --global --unset http.proxy
git config --global --unset https.proxy

若需使用代理，设置如下（端口根据实际修改）：

git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

4. SSH 方式（进阶）

若频繁使用，可配置 SSH Key 免密登录：

ssh-keygen -t ed25519 -C "[email protected]"

将公钥添加到 GitHub Settings -> SSH and GPG keys，并将远程地址改为 [email protected]:...。

六、图形化替代工具

若不习惯命令行，可使用 GitHub Desktop：

1. 下载：https://desktop.github.com/
2. 登录 GitHub。
3. Add Local Repository 选择本地文件夹。
4. Publish Repository 发布到云端。