IntelliJ IDEA配置Gitee私人令牌的完整指南(2025 年最新版)
前言
隨著代碼安全意識(shí)的提升，Gitee（碼云）已全面棄用明文密碼進(jìn)行 Git 操作，轉(zhuǎn)而強(qiáng)制使用 私人令牌（Personal Access Token, PAT） 進(jìn)行身份認(rèn)證。對(duì)于使用 IntelliJ IDEA 的開發(fā)者而言，正確配置 Gitee 賬號(hào)與令牌，是實(shí)現(xiàn)代碼推送、拉取、同步等操作的前提。
然而，許多用戶在配置過程中常遇到諸如“授權(quán)后顯示 404”、“登錄失敗”、“憑證錯(cuò)誤”等問題。
一、為什么需要私人令牌？
Gitee 自 2021 年起逐步取消對(duì) Git 操作中明文密碼的支持，主要原因包括：
- 防止密碼泄露與暴力 破解；
- 提高賬戶安全性；
- 支持細(xì)粒度權(quán)限控制（如僅允許讀倉(cāng)庫(kù)、不允許刪除項(xiàng)目等）；
因此，無論你是通過 HTTPS 還是 IDE 插件連接 Gitee，都必須使用私人令牌替代密碼。
二、配置方式概覽
| 方式 | 說明 | 推薦度 |
|---|---|---|
| ? Gitee 插件 + 私人令牌登錄 | 使用官方插件，通過 Token 登錄，管理方便 | ?????（推薦） |
| ? OAuth 授權(quán)登錄（Log In via Gitee） | 跳轉(zhuǎn)瀏覽器授權(quán)，但常因回調(diào)失敗導(dǎo)致 404 | ?（不推薦） |
| ? HTTPS + Token 嵌入 URL | 直接在遠(yuǎn)程地址中嵌入 用戶名:令牌 | ????（備選） |
| ? SSH 密鑰認(rèn)證 | 無需令牌，使用 SSH 公鑰 | ????（推薦，另文詳述） |
本文重點(diǎn)講解前兩種基于 私人令牌 的 HTTPS 配置方式。
三、步驟詳解：創(chuàng)建 Gitee 私人令牌
3.1 登錄 Gitee 并進(jìn)入個(gè)人設(shè)置
- 訪問 https://gitee.com 并登錄你的賬號(hào)。
- 點(diǎn)擊右上角頭像，選擇「個(gè)人設(shè)置」。
3.2 創(chuàng)建私人令牌
- 在左側(cè)菜單中找到并點(diǎn)擊「私人令牌」。
- 點(diǎn)擊「生成新令牌」按鈕。
- 填寫以下信息：
| 字段 | 建議值 | 說明 |
|---|---|---|
| 令牌名稱 | IDEA-Token 或 Workstation-Token | 便于識(shí)別用途 |
| 有效期 | 6個(gè)月 或 1年 | 不建議永久，便于安全管理 |
| 權(quán)限范圍 | 至少勾選 repo 和 user_info | repo：讀寫倉(cāng)庫(kù)；user_info：讀取用戶信息 |
可選權(quán)限：
- admin_repo_hook：管理 Webhook
- projects：訪問項(xiàng)目管理 API
- pages：管理 Gitee Pages
- 點(diǎn)擊「生成」按鈕。
3.3 復(fù)制并保存令牌
- 生成后，頁(yè)面會(huì)顯示一串類似
abc123xyz456的令牌字符串。 - 此字符串僅顯示一次，請(qǐng)立即復(fù)制并安全保存（建議使用密碼管理器如 1Password、Bitwarden）。
- 關(guān)閉頁(yè)面后無法再次查看，若丟失需重新生成。
四、在 IntelliJ IDEA 中配置 Gitee 賬號(hào)（推薦方案）
4.1 安裝 Gitee 插件（如未安裝）
- 打開 IntelliJ IDEA。
- 進(jìn)入菜單：
- Windows/Linux：
File→Settings→Plugins - macOS：
IntelliJ IDEA→Preferences→Plugins
- Windows/Linux：
- 在 Marketplace 中搜索
Gitee。 - 找到由 Gitee 官方提供的插件（注意不是第三方），點(diǎn)擊
Install。 - 安裝完成后重啟 IDEA。
插件功能：支持在 IDEA 內(nèi)直接登錄 Gitee、瀏覽倉(cāng)庫(kù)、創(chuàng)建 Issue、管理 Pull Request 等。
4.2 使用私人令牌登錄 Gitee 賬號(hào)
進(jìn)入設(shè)置：
File→Settings→Version Control→Gitee
點(diǎn)擊右上角的 + 號(hào)，選擇 「Log In with Tokens」。
不要選擇「Log In via Gitee」，該方式依賴 OAuth 回調(diào)，常因本地服務(wù)未啟動(dòng)或 Gitee 配置問題導(dǎo)致授權(quán)后跳轉(zhuǎn) localhost 失敗，顯示 404。
填寫登錄信息：
| 字段 | 值 |
|---|---|
| Host | https://gitee.com |
| Access Token | 粘貼你剛剛復(fù)制的私人令牌 |
| Refresh Token | 留空（Gitee 不支持刷新令牌） |
重要說明：Gitee 的私人令牌是靜態(tài)的，沒有刷新機(jī)制，因此 Refresh Token 字段無需填寫。
點(diǎn)擊 Add Account。若配置正確，IDEA 會(huì)顯示登錄成功，并列出你的 Gitee 用戶名和郵箱。
五、驗(yàn)證配置是否成功
方法一：通過 Gitee 插件驗(yàn)證
- 回到
Settings→Version Control→Gitee，確認(rèn)賬號(hào)已顯示為已登錄狀態(tài)。
方法二：執(zhí)行 Git 操作
- 打開一個(gè)已關(guān)聯(lián) Gitee 遠(yuǎn)程倉(cāng)庫(kù)的項(xiàng)目。
- 嘗試執(zhí)行：
VCS→Git→Pull- 或
Push
- 若操作成功，無認(rèn)證錯(cuò)誤提示，說明配置正確。
六、備選方案：直接配置 Git 遠(yuǎn)程 URL（無需插件）
如果你不想使用 Gitee 插件，也可以通過修改 Git 遠(yuǎn)程地址的方式使用令牌。
6.1 修改遠(yuǎn)程倉(cāng)庫(kù) URL
在終端或 IDEA 的 Git 工具中執(zhí)行：
git remote set-url origin https://<用戶名>:<私人令牌>@gitee.com/<用戶名>/<倉(cāng)庫(kù)名>.git
示例：
git remote set-url origin https://zhangsan:abc123xyz@gitee.com/zhangsan/my-project.git
6.2 配置憑據(jù)存儲(chǔ)（可選）
避免每次操作都輸入憑證：
# 將憑據(jù)保存到磁盤（明文，注意安全） git config --global credential.helper store # 或使用緩存（內(nèi)存中，重啟后清除） git config --global credential.helper cache
使用 store 時(shí)，憑據(jù)會(huì)以明文保存在 ~/.git-credentials 文件中，請(qǐng)確保系統(tǒng)安全。
七、常見問題與解決方案
| 問題 | 原因 | 解決方案 |
|---|---|---|
| 授權(quán)后顯示 404 | OAuth 回調(diào)失敗，IDEA 無法接收令牌 | 改用「Log In with Tokens」方式 |
| 認(rèn)證失敗 / 403 | 令牌錯(cuò)誤、過期或權(quán)限不足 | 檢查令牌是否復(fù)制正確，重新生成并確保勾選 repo 權(quán)限 |
| Push 成功但 Pull 失敗 | 憑據(jù)未持久化 | 配置 credential.helper 或重新登錄 |
| 插件無法安裝 | 網(wǎng)絡(luò)問題或倉(cāng)庫(kù)不可達(dá) | 檢查網(wǎng)絡(luò)，嘗試切換鏡像源 |
以上就是IntelliJ IDEA配置Gitee私人令牌的完整指南(2025 年最新版)的詳細(xì)內(nèi)容，更多關(guān)于IDEA配置Gitee私人令牌的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
Spring Boot中的 6 種API請(qǐng)求參數(shù)讀取方式示例詳解
使用Spring Boot開發(fā)API的時(shí)候,讀取請(qǐng)求參數(shù)是服務(wù)端編碼中最基本的一項(xiàng)操作,Spring Boot中也提供了多種機(jī)制來滿足不同的API設(shè)計(jì)要求,這篇文章主要介紹了Spring Boot中的 6 種API請(qǐng)求參數(shù)讀取方式示例詳解,需要的朋友可以參考下2024-05-05
Java 17引入了Text Blocks（文本塊）特性,這是Java語(yǔ)言中一種新的字符串表示方式,本文就來詳細(xì)的介紹一下文本塊的使用,感興趣的可以了解一下2025-10-10
這篇文章主要給大家介紹了關(guān)于SpringBoot如何防止XSS注入攻擊的相關(guān)資料，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2021-05-05
本文主要介紹java selenium 操作彈出窗口，這里實(shí)例講解操作彈出窗口詳細(xì)流程，并附示例代碼，有需要的小伙伴可以參考下2016-08-08
Spring Boot + Vue 基于 RSA 的用戶身份
RSA是一種非對(duì)稱加密算法,適用于用戶身份認(rèn)證加密,本文介紹了基于RSA的用戶身份認(rèn)證加密機(jī)制的實(shí)現(xiàn),包括前端Vue.js使用jsencrypt庫(kù)對(duì)用戶名密碼進(jìn)行加密,后端使用RSA私鑰解密驗(yàn)證用戶憑據(jù),感興趣的朋友跟隨小編一起看看吧2024-11-11
這篇文章主要介紹了如何將若依前后端分離項(xiàng)目打包成jar,不使用nginx轉(zhuǎn)發(fā),前端修改了路由模式和環(huán)境變量配置,后端增加了依賴、配置了Thymeleaf和訪問路徑,需要的朋友可以參考下2025-01-01
這篇文章主要為大家介紹了如何自定義parallelStream的線程池實(shí)現(xiàn)示例詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪2023-07-07
java中vector與hashtable操作實(shí)例分享
java中vector與hashtable操作實(shí)例，有需要的朋友可以參考一下2014-01-01
java讀取html文件,并獲取body中所有的標(biāo)簽及內(nèi)容的案例
這篇文章主要介紹了java讀取html文件,并獲取body中所有的標(biāo)簽及內(nèi)容的案例，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。一起跟隨小編過來看看吧2020-08-08
Springboot實(shí)現(xiàn)Java郵件任務(wù)過程解析
這篇文章主要介紹了Springboot實(shí)現(xiàn)Java郵件任務(wù)過程解析,文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2019-09-09