前言

隨著代碼安全意識(shí)的提升，Gitee（碼云）已全面棄用明文密碼進(jìn)行 Git 操作，轉(zhuǎn)而強(qiáng)制使用 私人令牌（Personal Access Token, PAT） 進(jìn)行身份認(rèn)證。對于使用 IntelliJ IDEA 的開發(fā)者而言，正確配置 Gitee 賬號(hào)與令牌，是實(shí)現(xiàn)代碼推送、拉取、同步等操作的前提。

然而，許多用戶在配置過程中常遇到諸如“授權(quán)后顯示 404”、“登錄失敗”、“憑證錯(cuò)誤”等問題。

一、為什么需要私人令牌？

Gitee 自 2021 年起逐步取消對 Git 操作中明文密碼的支持，主要原因包括：

• 防止密碼泄露與暴力 破解；
• 提高賬戶安全性；
• 支持細(xì)粒度權(quán)限控制（如僅允許讀倉庫、不允許刪除項(xiàng)目等）；

因此，無論你是通過 HTTPS 還是 IDE 插件連接 Gitee，都必須使用私人令牌替代密碼。

二、配置方式概覽

本文重點(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)擊「生成新令牌」按鈕。
• 填寫以下信息：

可選權(quán)限：

• admin_repo_hook：管理 Webhook
• projects：訪問項(xiàng)目管理 API
• pages：管理 Gitee Pages

• 點(diǎn)擊「生成」按鈕。

3.3 復(fù)制并保存令牌

• 生成后，頁面會(huì)顯示一串類似 abc123xyz456 的令牌字符串。
• 此字符串僅顯示一次，請立即復(fù)制并安全保存（建議使用密碼管理器如 1Password、Bitwarden）。
• 關(guān)閉頁面后無法再次查看，若丟失需重新生成。

四、在 IntelliJ IDEA 中配置 Gitee 賬號(hào)（推薦方案）

4.1 安裝 Gitee 插件（如未安裝）

1. 打開 IntelliJ IDEA。
2. 進(jìn)入菜單：
   • Windows/Linux：File → Settings → Plugins
   • macOS：IntelliJ IDEA → Preferences → Plugins
3. 在 Marketplace 中搜索 Gitee。
4. 找到由 Gitee 官方提供的插件（注意不是第三方），點(diǎn)擊 Install。
5. 安裝完成后重啟 IDEA。

插件功能：支持在 IDEA 內(nèi)直接登錄 Gitee、瀏覽倉庫、創(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。

填寫登錄信息：

重要說明：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 操作

1. 打開一個(gè)已關(guān)聯(lián) Gitee 遠(yuǎn)程倉庫的項(xiàng)目。
2. 嘗試執(zhí)行：
   • VCS → Git → Pull
   • 或 Push
3. 若操作成功，無認(rèn)證錯(cuò)誤提示，說明配置正確。

六、備選方案：直接配置 Git 遠(yuǎn)程 URL（無需插件）

如果你不想使用 Gitee 插件，也可以通過修改 Git 遠(yuǎn)程地址的方式使用令牌。

6.1 修改遠(yuǎn)程倉庫 URL

在終端或 IDEA 的 Git 工具中執(zhí)行：

git remote set-url origin https://<用戶名>:<私人令牌>@gitee.com/<用戶名>/<倉庫名>.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 文件中，請確保系統(tǒng)安全。

七、常見問題與解決方案

以上就是IntelliJ IDEA配置Gitee私人令牌的完整指南(2025 年最新版)的詳細(xì)內(nèi)容，更多關(guān)于IDEA配置Gitee私人令牌的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論