前言
随着代码安全意识的提升，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 配置方式。
三、步骤详解：创建 Gitee 私人令牌
3.1 登录 Gitee 并进入个人设置
- 访问 https://gitee.com 并登录你的账号。
- 点击右上角头像，选择「个人设置」。
3.2 创建私人令牌
- 在左侧菜单中找到并点击「私人令牌」。
- 点击「生成新令牌」按钮。
- 填写以下信息：
| 字段 | 建议值 | 说明 |
|---|---|---|
| 令牌名称 | IDEA-Token 或 Workstation-Token | 便于识别用途 |
| 有效期 | 6 个月 或 1 年 | 不建议永久，便于安全管理 |
| 权限范围 | 至少勾选 repo 和 user_info | repo：读写仓库；user_info：读取用户信息 |
🔹 可选权限：：管理 Webhook：访问项目管理 API：管理 Gitee Pages
