pycharm推送代码需先正确配置git路径和github认证：①在settings→version control→git中指定git.exe路径并test验证；②github登录必须匹配远程地址类型（https配token，ssh配密钥）；③首次推送须通过vcs→share project on github自动关联远程仓库，否则push会因无upstream失败。
直接用 PyCharm 自带的 Git 集成推送代码，比在终端敲命令更稳——前提是 Git 和 GitHub 账号都配对了，否则会卡在 git push 报错或弹窗反复要密码。
PyCharm 里 Git 可执行文件路径没设对
这是最常被忽略的前置条件：PyCharm 不自带 Git，必须手动指定本地安装的 git.exe（Windows）或 git（macOS/Linux）。路径填错，后面所有操作都会静默失败，连 Commit 按钮都可能是灰色的。
- 打开
File > Settings > Version Control > Git - 在
Path to Git executable栏点击右侧文件夹图标，找到你安装 Git 时的实际路径（例如 Windows 上通常是C:\Program Files\Git\bin\git.exe；macOS 上常用/usr/local/bin/git或which git输出的路径） - 点
Test，看到版本号（如git version 2.40.1）才算成功 - 如果
Test失败，别急着往下走——先确认系统终端里能运行git --version，再检查 PyCharm 是否用了错误的 shell 环境（比如 macOS 用户启用了 zsh，但 PyCharm 默认读取的是 bash 配置）
GitHub 登录方式选 Token 还是 SSH？
PyCharm 支持两种认证：网页登录（已弃用）、Personal Access Token（推荐）、SSH key（最省事）。选错会导致 Push failed: Authentication failed 或反复弹窗要密码。
GitHub Hosts 更新工具（仅限中国用户），安全更新系统hosts文件，保留原有非GitHub条目，仅替换GitHub相关地址。支持备份恢复和风险提示。用于解决GitHub访问问题。
- Token 方式：GitHub 设置里生成一个带
repo权限的 token，粘贴进 PyCharm 的Version Control > GitHub配置页。注意——2026 年起 GitHub 已停用密码登录，输密码必失败 - SSH 方式：更一劳永逸。先在终端运行
ssh-keygen -t ed25519 -C "your_email@example.com"，再把cat ~/.ssh/id_ed25519.pub输出内容粘到 GitHub 的Settings > SSH and GPG keys页面。配置完后，在 PyCharm 的GitHub设置中勾选Clone git repositories using ssh - 别混用：如果本地 Git remote 地址是
https://github.com/xxx/yyy.git，就得用 Token；如果是git@github.com:xxx/yyy.git，就得用 SSH —— 地址类型和认证方式必须匹配
第一次推送必须用 “Share Project on GitHub”
很多人直接右键项目 → Git > Commit Directory，再点 Push，结果报 fatal: The current branch has no upstream branch。因为本地仓库还没关联远程地址，PyCharm 不知道往哪儿推。
- 正确做法：点击顶部菜单
VCS > Import into Version Control > Share Project on GitHub - 这时 PyCharm 会自动创建远程仓库（需提前登录）、初始化本地 Git、add/commit 全部文件，并设置好
origin远程地址 - 它还会弹窗让你选要提交哪些文件（默认全选），并填写首次 commit message，别跳过这步
- 如果项目已有 .git 目录，这个菜单项会变灰——此时应改用
Git > Manage Remotes手动添加 remote，再Git > Push
Push 时提示 “Connection was reset” 或超时
这类网络错误不是代码问题，而是代理或 DNS 干扰，尤其在国内环境常见。PyCharm 内置终端和图形界面走的可能是不同网络栈，所以有时终端能 push 成功，GUI 却卡住。
- 先关掉全局代理：在终端执行
git config --global --unset http.proxy和git config --global --unset https.proxy - 检查 PyCharm 是否启用了内置代理（
Settings > Appearance & Behavior > System Settings > HTTP Proxy），设为No proxy - 如果用 SSH，确保
ssh -T git@github.com能返回Hi xxx! You've successfully authenticated；如果超时，可能是公司防火墙屏蔽了 22 端口，换 HTTPS + Token 更稳妥 - 别用 PyCharm 自带的 Terminal 窗口测试网络——它可能继承了 IDE 的代理设置，改用系统终端验证更准
真正麻烦的从来不是“怎么点”，而是哪一步配错了却没报明确错误。比如 Git 路径不对时，PyCharm 往往只让 Commit 按钮不可用，不告诉你为什么；Token 权限不够时，它可能只显示 Authentication failed，不提示缺了 repo scope。这些细节卡住的人最多，也最容易被教程跳过。
