从初始化到代理设置,亲测全流程可行 ✅
🪄 一、前言
很多人第一次想在 PyCharm 里提交代码到 GitHub,总会遇到一堆奇奇怪怪的报错:fatal: src refspec main does not match any、fetch first、failed to connect to github.com…… 我自己也是一路踩坑搞定的。 这篇文章就给你一份最全、最实用的 PyCharm + GitHub 推送教程, 从配置、命令到网络代理,一步到位!
🧩 二、PyCharm 环境配置
1️⃣ 打开 Git 设置
进入:
ounter(lineFile → Settings → Version Control → Git
👉 在 “Path to Git executable” 一栏,填上 Git 的安装路径,比如:
ounter(lineC:\Program Files\Git\bin\git.exe
点 “Test” 一下,看到 Git executed successfully 就说明 OK ✅
2️⃣ 登录 GitHub
进入:
ounter(lineFile → Settings → Version Control → GitHub
点击右侧 “+” 号 → “Log In via Browser”,浏览器会跳出 GitHub 授权页面。 登录成功后,PyCharm 会自动保存你的 GitHub 账号信息。
3️⃣ 检查 Version Control
打开:
ounter(lineVCS → Enable Version Control Integration → 选择 Git
这一步会让 PyCharm 识别当前项目为一个 Git 仓库。 如果成功,你会在右下角看到 “Git” 工具栏。
⚙️ 三、命令行初始化仓库
接下来打开 PyCharm 里的终端(Terminal),执行👇
ounter(lineounter(lineounter(linegit initgit add .git commit -m "first commit"
这几步的意思:
|
|
|
|---|---|
git init |
|
git add . |
|
git commit -m |
|
🌐 四、连接远程 GitHub 仓库
在 GitHub 上创建一个新仓库(repo),比如: xxxx:自己的github账号
ounter(linehttps://github.com/xxxx/python_auto.git
然后在终端执行:
ounter(lineounter(linegit remote add origin https://github.com/xxxx/python_auto.gitgit branch -M main
🚧 五、常见报错及解决方案
❌ 报错1:src refspec main does not match any
👉 原因:本地还没有 commit。 ✅ 解决:
ounter(lineounter(lineounter(linegit add .git commit -m "first commit"git push -u origin main
❌ 报错2:fetch first
👉 原因:远程仓库里有 README.md,本地和远程历史不一样。 ✅ 解决:
ounter(lineounter(linegit pull origin main --allow-unrelated-historiesgit push -u origin main
❌ 报错3:untracked working tree files would be overwritten
👉 原因:本地和远程有同名文件。 ✅ 解决:
ounter(lineounter(lineounter(lineren auto_daily__template.py auto_daily__template_local.pygit pull origin main --allow-unrelated-historiesgit push -u origin main
❌ 报错4:Failed to connect to github.com port 443
👉 原因:HTTPS 网络被墙。 ✅ 解决方案:给 Git 加上代理👇
ounter(lineounter(linegit config --global http.proxy http://127.0.0.1:7890git config --global https.proxy http://127.0.0.1:7890
(Clash / V2Ray 默认端口就是 7890)
然后再执行:
ounter(linegit push -u origin main
💥 成功推送!
🌈 六、PyCharm 一键提交
如果不想敲命令,也可以用图形化操作👇
1️⃣ 右下角点 “Git” 2️⃣ 点击「Commit」→ 填写提交信息 3️⃣ 再点「Push」 4️⃣ 选择远程仓库 → OK!
PyCharm 会自动执行对应命令,非常丝滑。
🧠 七、网络代理小贴士
|
|
|
|---|---|
|
|
git config --global --list |
|
|
git config --global --unset http.proxy |
|
|
git config --global https.proxy socks5://127.0.0.1:7891 |
🎉 八、成功标志
当你看到👇
ounter(lineounter(lineounter(lineTo https://github.com/xxxx/python_auto.git* [new branch] main -> mainbranch 'main' set up to track 'origin/main'.
就说明已经 100% 成功啦!🥳 刷新 GitHub 页面,就能看到所有文件!
🔥 九、总结
✅ 从 PyCharm 设置到 GitHub 推送全流程 ✅ 涵盖所有常见报错和解决方式 ✅ 附带网络代理终极解法
一句话:
别怕命令行,Git 其实没那么难,懂原理+会避坑=稳!

