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),确实需要装插件,但强烈建议升级。若必须操作:
- 进入
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。这三处任一出错,都会让整个流程卡在“连接失败”界面,看起来像插件问题,其实跟插件无关。


















