IDEA 连接 Gitee 配置及代码推送指南

一、安装 / 启用 Gitee 插件（关键前提）

IDEA 2020 及以上版本已内置 Gitee 插件，无需手动下载，只需确认启用即可：

1. 打开 IDEA，进入设置界面：
   • Windows/Linux：File → Settings（快捷键 Ctrl+Alt+S）
   • Mac：IntelliJ IDEA → Settings（快捷键 Cmd+,）
2. 在设置窗口左侧，展开 Plugins（插件），顶部切换到 Installed（已安装）标签；
3. 在搜索框输入 Gitee，找到插件后确保复选框已勾选（未勾选则勾选并点击 Apply → OK，IDEA 无需重启）；

若未找到 Gitee 插件：切换到 Marketplace 标签，搜索 Gitee 安装，安装后点击 Restart IDEA 重启生效。

二、获取 Gitee 私人令牌（Access Token，替代密码）

Gitee 已不再支持直接使用账号密码连接 IDEA，必须通过私人令牌验证，步骤如下：

1. 打开 Gitee 官网（https://gitee.com/），登录你的账号；
2. 进入个人设置：点击页面右上角头像 → 设置；
3. 左侧导航栏找到私人令牌（Access Token），点击进入；
4. 点击生成新令牌，配置令牌信息：
   • 令牌名称：自定义（如 IDEA-Connection，便于识别）；
   • 权限勾选：至少勾选 repo（仓库相关，拉取 / 推送代码核心权限），其他权限按需勾选；
   • 有效期：按需选择（建议选「永久」，避免频繁重新生成）；

输入 Gitee 登录密码验证，点击生成，生成后立即复制令牌（仅显示一次，关闭页面后无法查看，复制后妥善保存）。

三、IDEA 配置 Gitee 账号（关联令牌）

1. 回到 IDEA 设置界面（Ctrl+Alt+S/Cmd+,），左侧展开 Version Control → Gitee；
2. 右侧界面：Host 保持默认 https://gitee.com/ 无需修改；
3. 点击 + 号（添加账号），在弹出的窗口中：
   • Login：输入你的 Gitee 用户名（不是邮箱，可在 Gitee 「个人设置 → 个人资料」中查看）；
   • Password：粘贴第二步生成的私人令牌（不是 Gitee 登录密码）；

点击 OK，回到 Gitee 配置页面，点击 Test Connection（测试连接）。

四、验证连接成功

若弹出提示 Connection successful（连接成功），说明 IDEA 已成功关联 Gitee 账号，可直接使用 IDEA 进行克隆 Gitee 仓库、推送本地代码到 Gitee、拉取远程代码等操作。

五、IDEA 推送本地代码到 Gitee

1. 首次推送：本地无 Git 仓库时

1. 初始化本地 Git 仓库
   • 打开你的项目，依次点击 VCS → Create Git Repository。
   • 在弹出的窗口中选择项目根目录，点击 OK，完成本地仓库初始化。
2. 将项目文件加入 Git 暂存区
   • 在 IDEA 右侧的 Project 视图中，右键点击项目根目录，选择 Git → Add。
3. 第一次提交本地代码
   • 依次点击 Git → Commit（快捷键 Ctrl+K / Cmd+K）。
4. 关联 Gitee 远程仓库
   • 先在 Gitee 官网创建一个空白仓库，复制仓库的 HTTPS 地址（如 https://gitee.com/你的用户名/仓库名.git）。
   • 回到 IDEA，依次点击 Git → Remotes。
   • 在弹窗中点击 +，Name 填写 origin（默认远程仓库名），URL 粘贴刚才复制的仓库地址，点击 OK。
5. 推送代码到 Gitee
   • 依次点击 Git → Push（快捷键 Ctrl+Shift+K / Cmd+Shift+K）。

在推送窗口中，确认分支为 main（或 master），远程仓库为 origin，点击 Push 即可完成首次推送。

若没有 Remotes，点击菜单中的 Manage Remotes... 选项。在弹出的窗口中，点击 + 号，输入远程仓库名称（一般用 origin）和 Gitee 仓库的 HTTPS 地址（例如：https://gitee.com/你的用户名/仓库名.git）。

在提交窗口中，填写提交信息（如 init: 初始化项目），确认文件无误后点击 Commit。

此时文件会从红色变为绿色，表示已加入暂存区。

完成之后 VCS 变成 git。

2. 日常推送：已有本地仓库且关联远程时

1. 修改代码后，将变更文件加入暂存区
   • 右键点击变更的文件 / 目录，选择 Git → Add；或在 IDEA 底部的 Git 工具窗口中，勾选要提交的文件。
2. 提交本地变更
   • 按 Ctrl+K / Cmd+K 打开提交窗口，填写提交信息，点击 Commit。
3. 推送到 Gitee
   • 按 Ctrl+Shift+K / Cmd+Shift+K 打开推送窗口，确认分支和远程仓库无误后，点击 Push 即可。