一、安装 / 启用 Gitee 插件(关键前提)
IDEA 2020 及以上版本已内置 Gitee 插件,无需手动下载,只需确认启用即可:
- 打开 IDEA,进入设置界面:
- Windows/Linux:
File → Settings(快捷键Ctrl+Alt+S) - Mac:
IntelliJ IDEA → Settings(快捷键Cmd+,)
- Windows/Linux:
- 在设置窗口左侧,展开
Plugins(插件),顶部切换到Installed(已安装)标签; - 在搜索框输入
Gitee,找到插件后确保复选框已勾选(未勾选则勾选并点击Apply → OK,IDEA 无需重启);
若未找到 Gitee 插件:切换到 Marketplace 标签,搜索 Gitee 安装,安装后点击 Restart IDEA 重启生效。

二、获取 Gitee 私人令牌(Access Token,替代密码)
Gitee 已不再支持直接使用账号密码连接 IDEA,必须通过私人令牌验证,步骤如下:
- 打开 Gitee 官网(https://gitee.com/),登录你的账号;
- 进入个人设置:点击页面右上角头像 → 设置;
- 左侧导航栏找到私人令牌(Access Token),点击进入;
- 点击生成新令牌,配置令牌信息:
- 令牌名称:自定义(如
IDEA-Connection,便于识别); - 权限勾选:至少勾选
repo(仓库相关,拉取 / 推送代码核心权限),其他权限按需勾选; - 有效期:按需选择(建议选「永久」,避免频繁重新生成);
- 令牌名称:自定义(如
输入 Gitee 登录密码验证,点击生成,生成后立即复制令牌(仅显示一次,关闭页面后无法查看,复制后妥善保存)。


三、IDEA 配置 Gitee 账号(关联令牌)
- 回到 IDEA 设置界面(
Ctrl+Alt+S/Cmd+,),左侧展开Version Control → Gitee;











