pycharm 找不到 git.exe 的根本原因是未正确配置 git 可执行文件路径或环境变量未生效；需通过 where git 确认实际路径，填入 c:\program files\git\bin\git.exe 并点击 test 验证，之后必须重启 pycharm。
PyCharm 找不到 git.exe 怎么办
根本原因通常是 PyCharm 没法定位到本地 Git 安装路径，不是没装 Git，而是路径没填对或环境变量没生效。
-
git.exe默认在 Windows 上是C:\Program Files\Git\bin\git.exe（64位）或C:\Program Files (x86)\Git\bin\git.exe（32位），别选cmd\git.exe—— 那个不支持 PyCharm 的底层调用 - 如果点击
Test提示 “Cannot run program 'git'”，先打开终端执行where git（Windows）或which git（macOS/Linux），确认实际路径 - 填完路径后必须点
Test，成功才代表 PyCharm 能真正调用 Git；仅“路径存在”不等于“可执行” - 重启 PyCharm 不是可选项——改完 Git 路径后必须重启，否则旧缓存会卡住 VCS 功能
现有项目怎么初始化本地 Git 仓库
别从 GitHub 页面新建空仓库再克隆——那是为全新项目准备的。已有代码文件夹，直接初始化最省事。
Git Repo Reader
下载
辅助阅读和快速理解 GitHub/Git 项目结构与核心价值的结构化方法论。 当用户请求"分析这个 GitHub 项目"、"帮我读一下这个 repo"、"了解这个项目是做什么的"、 "怎么用这个项目"、"怎么跑这个项目"、"这个项目用了哪些技术"，或任何涉及 GitHub/Git 仓库阅读、理解、技术评估、快速上...
- 菜单栏选
VCS → Import into Version Control → Create Git Repository…，然后选中你的项目根目录（不是子文件夹） - 成功后，项目里会出现
.git文件夹（默认隐藏，需在系统文件管理器中开启“显示隐藏文件”才能看见） - PyCharm 左侧项目视图里，未跟踪的文件显示为红色，
.idea、*.iml这类 IDE 文件默认也变红——它们不该进 Git，右键 →Git → Add to .gitignore即可忽略 - 别手动运行
git init命令行再回 PyCharm —— IDE 可能无法自动识别已存在的.git目录，导致 VCS 面板空白
第一次提交为什么卡在邮箱配置
Git 要求每次 commit 记录作者身份，PyCharm 在首次提交时会弹窗要你填 user.email 和 user.name，这不是 Bug，是强制校验。
- 邮箱必须和 GitHub 账号注册邮箱一致，否则后续 push 会失败并提示 “author email not verified”
- 名字可以任意填，但建议用真实姓名或 GitHub 昵称，保持团队可追溯性
- 填完后 PyCharm 会自动写入全局 Git 配置（
~/.gitconfig），之后所有项目都复用这套信息，不用重复输 - 如果误填了错误邮箱，不能只在 PyCharm 里改——得去终端执行
git config --global user.email "correct@example.com"才能彻底修正
Push 到 GitHub 总失败：Token 和 URL 对不上
GitHub 已停用密码认证，必须用 Personal Access Token（PAT），且 Token 权限、URL 协议、远程名三者必须匹配。
- 生成 Token 时至少勾选
repo（完整仓库权限），delete_repo不用勾——除非真要删仓库 - PyCharm 登录 GitHub 账户时粘贴的是 Token 字符串本身，不是网页 URL，也不是登录页地址
- 远程 URL 必须用 HTTPS 格式（如
https://github.com/username/repo.git），别用 SSH（git@github.com:...）——PyCharm 的 Token 认证只支持 HTTPS - 远程名建议统一用
origin，避免出现upstream、origin2等多远程混乱；推送前先看右下角 Git 状态栏是否显示origin/main或类似分支跟踪关系
.gitignore 是否生效，结果把 __pycache__ 或大型数据文件一起推上去，导致仓库臃肿甚至 push 超时。动手前花 30 秒右键项目根目录 → Git → Show History 看一眼暂存区内容，比事后清理快得多。
