pycharm必须正确配置git可执行文件路径（如windows下c:\program files\git\bin\git.exe）并点击test验证，同时需提前执行git config --global user.name和user.email设置作者信息，否则commit会因“empty ident name”失败。
git 可执行文件没配对，PyCharm 就没法做任何 Git 操作——连 git init 都会报错，更别说提交、推送了。配置本身不难，但路径选错、权限卡住、用户信息漏设，三者任一出问题，后续所有操作都会卡在第一步。
怎么找到并填对 git.exe 路径
PyCharm 不自带完整 Git 运行时（哪怕新版也只带极简 shell），必须指向你本地安装的 Git 可执行文件。
- Windows 用户通常装在
C:\Program Files\Git\bin\git.exe或C:\Users\用户名\AppData\Local\Programs\Git\bin\git.exe；别选cmd\git.exe，那个是包装器，PyCharm 会识别失败 - macOS 用户路径一般是
/usr/local/bin/git或/opt/homebrew/bin/git（M1/M2 芯片）；用终端执行which git最准 - Linux 用户常见路径为
/usr/bin/git；如果用 snap 安装，可能需要手动 symlink 到标准路径，否则 PyCharm 无法调用 - 填完务必点
Test按钮——它实际执行git --version，成功才说明路径和权限都 OK
为什么 git config --global user.name 必须提前设
PyCharm 提交时不会帮你补全局用户信息，一旦缺了，git commit 直接失败，报错：fatal: empty ident name (for ) not allowed。
Conventional Git
下载
Conventional Commits v1.0.0 分支、工作树命名及提交信息规范，适用于 GitHub 与 GitLab 项目，用于创建分支和命名工作树等场景。
- 必须在 PyCharm 内置终端（
View → Tool Windows → Terminal）里运行两行命令： git config --global user.name "你的 GitHub 昵称"git config --global user.email "你在 GitHub 绑定的邮箱"- 注意：邮箱必须和 GitHub 账号完全一致，否则提交记录不会关联到你的 GitHub 主页
- 别信 PyCharm 设置里“Author”字段能替代这个——它只影响当前提交弹窗预填，不写进 Git 全局配置
远程推送失败？大概率是认证方式不对
GitHub 已停用密码认证，git push 报 remote: Support for password authentication was removed 是最常见症状。
- PyCharm 2023.3+ 默认支持 GitHub Token 认证，但得手动填：进入
Settings → Version Control → GitHub，点击+ Add account，选择Token方式 - Token 必须带
repo权限（不是仅read:user），否则push会被拒绝 - 如果用 SSH 方式，确保
~/.ssh/id_ed25519.pub已添加到 GitHub 的 SSH Keys，且 PyCharm 终端能执行ssh -T git@github.com成功 - 检查远程地址是否为 SSH 格式（
git@github.com:user/repo.git）还是 HTTPS 格式（https://github.com/user/repo.git）——混用会导致凭证冲突
.gitignore 的静默处理：它默认把 .idea/、*.iml 加进忽略列表，但如果你手动删过这些规则，或项目从别处复制过来没带 .gitignore，PyCharm 仍会按自己逻辑标记文件状态，导致你误以为某些文件“没加进 Git”，其实是被悄悄忽略了。
