Javajava
IntelliJ IDEA 配置 Gitee 私人令牌教程
在 IntelliJ IDEA 中配置 Gitee 私人令牌（PAT）的方法。内容包括创建 Gitee 令牌的步骤、在 IDEA 中通过插件或修改远程 URL 进行配置的两种方式，以及验证配置是否成功和常见问题的解决方案。旨在帮助开发者解决因密码弃用导致的认证失败问题，实现安全的代码同步操作。
在 IntelliJ IDEA 中配置 Gitee 私人令牌（PAT）的方法。内容包括创建 Gitee 令牌的步骤、在 IDEA 中通过插件或修改远程 URL 进行配置的两种方式，以及验证配置是否成功和常见问题的解决方案。旨在帮助开发者解决因密码弃用导致的认证失败问题，实现安全的代码同步操作。
随着代码安全意识的提升，Gitee（码云）已全面弃用明文密码进行 Git 操作，转而强制使用 私人令牌（Personal Access Token, PAT） 进行身份认证。对于使用 IntelliJ IDEA 的开发者而言，正确配置 Gitee 账号与令牌，是实现代码推送、拉取、同步等操作的前提。
然而，许多用户在配置过程中常遇到诸如'授权后显示 404'、'登录失败'、'凭证错误'等问题。
Gitee 自 2021 年起逐步取消对 Git 操作中明文密码的支持，主要原因包括：
因此，无论你是通过 HTTPS 还是 IDE 插件连接 Gitee，都必须使用私人令牌替代密码。
| 方式 | 说明 | 推荐度 |
|---|---|---|
| ✅ Gitee 插件 + 私人令牌登录 | 使用官方插件，通过 Token 登录，管理方便 | ⭐⭐⭐⭐⭐（推荐） |
| ❌ OAuth 授权登录（Log In via Gitee） | 跳转浏览器授权，但常因回调失败导致 404 | ⭐（不推荐） |
| ✅ HTTPS + Token 嵌入 URL | 直接在远程地址中嵌入 用户名：令牌 | ⭐⭐⭐⭐（备选） |
| ✅ SSH 密钥认证 | 无需令牌，使用 SSH 公钥 | ⭐⭐⭐⭐（推荐，另文详述） |
本文重点讲解前两种基于 私人令牌 的 HTTPS 配置方式。
| 字段 | 建议值 | 说明 |
|---|---|---|
| 令牌名称 | IDEA-Token 或 Workstation-Token | 便于识别用途 |
| 有效期 | 6 个月 或 1 年 | 不建议永久，便于安全管理 |
| 权限范围 | 至少勾选 repo 和 user_info | repo：读写仓库；user_info：读取用户信息 |
🔹 可选权限：
admin_repo_hook：管理 Webhookprojects：访问项目管理 APIpages：管理 Gitee Pages
abc123xyz456 的令牌字符串。关闭页面后无法再次查看，若丢失需重新生成。
File → Settings → PluginsIntelliJ IDEA → Preferences → PluginsGitee。Install。安装完成后重启 IDEA。
💡 插件功能：支持在 IDEA 内直接登录 Gitee、浏览仓库、创建 Issue、管理 Pull Request 等。
File → Settings → Version Control → Gitee点击右上角的 + 号，选择 「Log In with Tokens」。
⚠️ 不要选择「Log In via Gitee」，该方式依赖 OAuth 回调，常因本地服务未启动或 Gitee 配置问题导致授权后跳转
localhost失败，显示 404。
| 字段 | 值 |
|---|---|
| Host | https://gitee.com |
| Access Token | 粘贴你刚刚复制的私人令牌 |
| Refresh Token | 留空（Gitee 不支持刷新令牌） |
📌 重要说明：Gitee 的私人令牌是静态的，没有刷新机制，因此
Refresh Token字段无需填写。
若配置正确，IDEA 会显示登录成功，并列出你的 Gitee 用户名和邮箱。
Settings → Version Control → Gitee，确认账号已显示为已登录状态。VCS → Git → PullPush如果你不想使用 Gitee 插件，也可以通过修改 Git 远程地址的方式使用令牌。
在终端或 IDEA 的 Git 工具中执行：
git remote set-url origin https://<用户名>:<私人令牌>@gitee.com/<用户名>/<仓库名>.git
示例：
git remote set-url origin https://zhangsan:[email protected]/zhangsan/my-project.git
避免每次操作都输入凭证：
# 将凭据保存到磁盘（明文，注意安全）
git config --global credential.helper store
# 或使用缓存（内存中，重启后清除）
git config --global credential.helper cache
⚠️ 使用
store时，凭据会以明文保存在~/.git-credentials文件中，请确保系统安全。
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 授权后显示 404 | OAuth 回调失败，IDEA 无法接收令牌 | 改用「Log In with Tokens」方式 |
| 认证失败 / 403 | 令牌错误、过期或权限不足 | 检查令牌是否复制正确，重新生成并确保勾选 repo 权限 |
| Push 成功但 Pull 失败 | 凭据未持久化 | 配置 credential.helper 或重新登录 |
| 插件无法安装 | 网络问题或仓库不可达 | 检查网络，尝试切换镜像源 |
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online