pycharm 2021.3 及之后版本内置 github 插件，默认启用，无需手动安装；若 settings 中缺失 github 配置项，说明插件被禁用，需在 plugins 中启用并重启 ide。

PyCharm 2021.3 及之后版本不需要手动安装 GitHub 插件

从 PyCharm 2021.3 开始，GitHub 集成已内置，GitHub 插件默认启用，无需额外安装。你能在 Settings → Version Control → GitHub 直接配置账号。如果该菜单项缺失，说明插件被意外禁用，而不是没装。

插件被禁用时如何重新启用

常见现象是：Settings 里找不到 GitHub 选项，或点击 VCS → Import into Version Control → Share Project on GitHub 报错提示 “No GitHub account configured” 但又没地方填账号。

• 打开 Settings → Plugins
• 在搜索框输入 GitHub
• 检查列表中是否显示 GitHub（不是 GitToolBox 或第三方插件）
• 若状态为 Disabled，勾选它，点击 OK，重启 PyCharm

重启后，Settings → Version Control → GitHub 就会出现。注意：不要安装名字含 github-integration 或 old-github-plugin 的非官方插件，它们可能与新版冲突。

旧版 PyCharm（如 2020.3 或更早）才需手动安装

如果你用的是已停止支持的旧版本（比如 PyCharm Community 2020.1），确实需要装插件，但强烈建议升级。若必须操作：

Permanently Clear Files from Git History

帮助用户永久删除 Git 仓库历史中的文件，适用于用户提及 “git filter-repo” 等场景。

下载

• 进入 Settings → Plugins
• 点右上角 Marketplace 标签
• 搜索 GitHub，认准作者是 JetBrains
• 点击 Install，完成后重启

装完仍需在 Settings → Version Control → Git 先配好 Path to Git executable，否则 GitHub 配置页会灰掉不可用——这是最容易卡住的一步，不是插件问题，是 Git 路径没设对。

配 GitHub 账号时用 Personal Access Token（PAT）而非密码

GitHub 自 2021 年 8 月起停用密码登录 API，PyCharm 会报错 Authentication failed. Please check your credentials. 即使用户名密码没错。

• 去 https://www.php.cn/link/f4380fd29ac34f2610014e8361d088fb 新建 token
• 勾选 repo 和 workflow（其他权限按需加）
• 复制生成的 token 字符串（只显示一次！）
• 回到 PyCharm 的 GitHub 配置页，用户名填你的 GitHub 用户名，Password 栏粘贴 token

别用邮箱代替用户名，也别把 token 存在本地明文文件里——PyCharm 会安全保存，但你自己别手贱写进 .env 或代码注释里。

真正容易被忽略的不是插件装不装得上，而是 Git 可执行文件路径没配、token 权限不够、或者用了已过期的旧 token。这三处任一出错，都会让整个流程卡在“连接失败”界面，看起来像插件问题，其实跟插件无关。