廣告位招商中 歡迎洽談

在主流 IDE 中啟用與配置 JetBrains AI Assistant 實戰指南

365Finds Editorial
已收錄 11,430 篇 Wiki 文章

讓你的 AI 用上 365 Wiki

複製下方的提示詞,貼給你常用的 AI,然後直接提問。

下載完整版 Skill

先用提示詞體驗;經常使用時,安裝完整版 365Wiki Skill,以後無需重複複製。沒有常用 AI?Gemini、Microsoft Copilot 等網頁版也可以。

365Wiki Skill

JetBrains AI Assistant 將生成式 AI 編程功能、自主多步驟代理(Agent)以及深度語義程式碼智慧直接整合至 JetBrains 開發環境中,支援包含 IntelliJ IDEA、PyCharm、WebStorm、GoLand、CLion、Rider、PhpStorm、RubyMine、RustRover、DataGrip 與 DataSpell 在內的全系列 IDE。該助手並非獨立運作的聊天介面或通用的文字預測器,而是深度連接 IDE 內部的專案索引、抽象語法樹(AST)和版本控制系統,以提供具備情境感知能力的程式碼生成、多行自動完成、後續編輯建議(Next Edit Suggestions)、自動化測試編寫以及結構化重構。成功部署與設定 JetBrains AI Assistant 需要軟體開發人員與工程團隊主管確認 IDE 版本先決條件、完成個人或企業層級的安裝與授權啟用、調校編輯器內的自動完成參數、建立儲存庫層級的專案規則,並針對模型提供商與外部模型情境通訊協定(MCP)工具配置安全邊界。

IDE 相容性與版本先決條件

在啟用 JetBrains AI Assistant 之前,開發人員必須確保本機環境符合特定的執行階段、平台與組織條件。

支援的環境與 IDE 基準版本

JetBrains AI Assistant 以附加元件(外掛程式)的形式發行,適用於 JetBrains 產品系列。受支援的 IDE 需要符合特定的基準版本:

運算拓撲:雲端 LLM 與本機硬體

在預設狀態下,JetBrains AI Assistant 透過 JetBrains AI 服務或第三方 API 提供商代管的雲端大型語言模型執行推論。在此組態下,開發人員工作站幾乎不會產生額外的 CPU、GPU 或電池負載。

然而,對於採用自我託管開放權重模型(例如 Ollama 或私有 OpenAI 相容推論端點)的團隊,則必須在工作站配置專用運算資源,包含充裕的專用視訊記憶體(VRAM,依參數量化程度通常需要 8 GB 至 24 GB),以確保即時的 Token 串流輸出。

組織先決條件

對於使用由雇主或教育機構派發之 IDE 授權的開發人員,AI 功能的存取權限在組織層級進行控管:

  1. 組織管理員必須在企業 JetBrains Account 管理控制台中啟用 JetBrains AI 服務。
  2. 若組織實施嚴格的智財權治理或安全防護政策,管理員可在開發人員進行啟用前分配共用點數池或指定核准的第三方提供商。

安裝與啟用 JetBrains AI Assistant

JetBrains AI Assistant 外掛程式在個人安裝環境中預設為停用狀態,且在明確安裝並完成啟用前,絕不會存取專有原始碼。

安裝途徑

開發人員可透過支援的 IDE 中的三個主要入口安裝該外掛程式:

  1. JetBrains Marketplace(設定介面):
    • 在 Windows/Linux 上按下 Ctrl+Alt+S 開啟 Settings,或在 macOS 上按下 Cmd+, 開啟 Preferences。
    • 在左側邊欄選擇 Plugins,並切換至 Marketplace 分頁。
    • 在搜尋欄輸入 AI Assistant。
    • 在官方 JetBrains 外掛程式項目點擊 Install,並在出現提示時重新啟動 IDE。
  2. AI Chat 工具視窗:
    • 點擊右側工具視窗停靠列上的 AI Chat 圖示。
    • 點擊空白工具視窗內顯示的 Install Plugin 按鈕以觸發背景安裝。
  3. JetBrains AI 視窗標題列小工具:
    • 在現代 IDE 介面標題列中,找到 JetBrains AI 狀態小工具。
    • 點擊 Let's Go 即可自動下載並初始化外掛程式。

授權層級與啟用情境

安裝完成後,開發人員必須使用對應的授權模式啟用外掛程式。JetBrains 在啟用情境下支援多種驗證管道:

啟用選項是否需要訂閱可用功能主要計費實體
JetBrains AI 訂閱是(Free、Pro、Business、Ultimate、Enterprise)完整存取所有雲端模型、內建代理、內嵌自動完成與後續編輯建議JetBrains(每月配額或企業共用點數池)
自備金鑰(BYOK)否(使用第三方 API 金鑰)所選第三方模型支援的內嵌自動完成與聊天功能第三方提供商(OpenAI、Anthropic、Google Vertex AI)
提供商帳戶(OAuth)否(透過提供商 OAuth 登入)僅限所驗證代理的專用存取權限(例如 Claude Agent、GitHub Copilot)專用代理提供商
ACP 相容代理否透過 Agent Client Protocol 與自訂外部代理介接獨立代理提供商
本機 / 自訂模型否本機推論伺服器所支援的功能(例如 Ollama、vLLM)自我託管基礎架構

授權層級詳細分析

法律條款與使用協議同意

在初始啟用交互過程中,開發人員必須檢閱並接受 JetBrains AI 服務條款與可接受使用政策。這些條款以法律形式確立:傳送以供推論的原始碼僅作短暫即時處理,絕不會被保留用於訓練基礎公開基座模型。


IDE 核心組態與行為設定

外掛程式的全域設定選項集中在 Settings | Tools | AI Assistant(macOS 上為 Preferences | Tools | AI Assistant)。檢閱設定參考文件有助於開發人員使工具符合自身的編程習慣。

Settings / Preferences
  ├── Tools
  │     └── AI Assistant
  │           ├── General Features (Name suggestions, pasted code, PR summaries)
  │           ├── Providers & API keys (BYOK, OAuth, Model selection)
  │           ├── Rules (Project-specific instructions)
  │           ├── Prompt Library (Custom prompt templates)
  │           ├── Skills (Debugger and runtime tools)
  │           └── Agents (ACP agent registries)
  └── Editor
        └── General
              └── Code Completion
                    └── Inline (Cloud completion, Next Edit Suggestions)

自動化功能切換開關

開發人員可視需求切換特定的輔助行為開關,避免不必要的干擾:

自然語言客製化

在預設情況下,AI Assistant 以系統語系或英文回應。在多語環境中工作的團隊可在 Settings | Tools | AI Assistant | Natural Language 中指定慣用的自然語言,以確保程式碼解釋、說明文件註解(Docstring)與 Commit 訊息均能以指定的工作語言產生。

訊息裁剪臨界值(Message Trimming Threshold)

在處理大型程式碼庫時,附加多個原始碼檔案可能會迅速消耗大上下文視窗。在 Settings | Tools | AI Assistant 中,開發人員可以設定 Message Trimming Threshold(以模型總上下文視窗的百分比表示)。若附加的承載資料超過此臨界值,AI Assistant 會自動裁剪外層非關鍵結構,同時保留相關的函式簽名與呼叫點,以防超出上下文邊界引發 Token 溢位例外。


設定編輯器內程式碼完成與後續編輯建議

JetBrains IDE 在程式碼自動完成方面採用雙引擎架構:本機裝置端自動完成與遠端雲端自動完成。

本機整行自動完成與雲端多行自動完成比較

掌握不同補全機制的差異對於達成最佳化設定至關重要:

  1. 整行程式碼完成(Full Line Code Completion):完全在開發人員的工作站本機執行,使用直接內建於 IDE 的精簡特定語言神經網路模型。其運作處於完全離線狀態,具備零網路延遲特性,不消耗 AI 點數,亦不會將程式碼傳送出本機。
  2. 雲端程式碼完成(Cloud Code Completion):由 AI Assistant 雲端 LLM 驅動。它能依據更廣泛的檔案情境,產生跨多行的程式碼結構、完整方法主體、演算法邏輯以及隨附的說明文件註解。

設定內嵌自動完成參數

如需微調內嵌自動完成,請前往 Settings | Editor | General | Code Completion | Inline:

鍵盤快速鍵與採納控制

可使用標準按鍵組合採納或捨棄內嵌虛影建議:


AI Chat、情境管理與專案規則

AI Chat 工具視窗充當互動式結對編程環境,能夠跨檔案、呼叫堆疊追蹤(Stack Traces)以及專案歷史紀錄進行深度推理。

使用 Mention 引用情境

開發人員不需將原始碼片段手動複製貼上至聊天對話方塊,而是應該使用 @ 符號引用目標情境:

使用 /docs 查詢官方說明文件

需要 IDE 操作指引的開發人員可直接在聊天輸入框中使用 /docs 指令查詢 JetBrains 官方文件。例如輸入:

/docs how do I configure remote Docker debugging for GoLand?

該指令會對 JetBrains 官方產品說明文件發起檢索增強生成(RAG)查詢,回傳標準操作步驟,並附帶可直接點擊開啟 IDE 設定對話方塊的深層連結。

自訂提示詞庫(Prompt Library)

團隊經常需要重複執行特定架構模式,例如建立倉儲類別、模擬 HTTP 用戶端或遷移舊有架構。開發人員可透過 Settings | Tools | AI Assistant | Prompt Library 將這些提示標準化:

  1. 點擊新增(+)建立新的自訂提示範本。
  2. 定義具描述性的標題(例如 Generate Spring Data JPA Repository)。
  3. 輸入範本文字,並使用如 $SELECTION 等動態預留位置代表反白選取的程式碼。
  4. 將該提示指派至編輯器右鍵選單,以便快速一鍵執行。

透過專案規則落實規範(ai-rules.md)

為了避免 AI Assistant 產生違反專案常規的程式碼,團隊可在 Settings | Tools | AI Assistant | Rules 中建立持續生效的專案規則,或在儲存庫根目錄提交 Markdown 檔案 .jetbrains/ai-rules.md。

一份架構完善的規則檔案能在系統架構邊界、風格規範及測試模式等方面為助手提供明確指引:

# Project Architectural Guidelines

## Technology Stack
- Java 21 LTS with Spring Boot 3.3
- Build Tool: Gradle with Kotlin DSL
- Testing: JUnit 5, AssertJ, and Testcontainers (avoid Mockito for integration tests)

## Code Conventions
- Prefer immutable records for Data Transfer Objects (DTOs).
- Enforce explicit constructor injection; do not use field-level `@Autowired`.
- All public REST controllers must return `ResponseEntity<T>` with OpenAPI 3 annotations.
- Handle database operations asynchronously via R2DBC where reactive pipelines are present.

## Security Constraints
- Never log raw authorization tokens, customer personally identifiable information (PII), or passwords.
- Enforce parameter binding on all SQL and JPQL queries to prevent injection vulnerabilities.

AI Assistant 會自動讀取 .jetbrains/ai-rules.md,並將其規範限制附加到在該儲存庫中發送的所有提示內,確保產生的程式碼嚴格符合團隊標準。


編程代理、ACP 與模型情境通訊協定(MCP)

新版 JetBrains AI Assistant 已由被動的程式碼建議,進一步擴展為具備主動性與自主性的代理(Agent)工作流程。

自主編程代理

在 Settings | Tools | AI Assistant | Agents 中,開發人員可設定專屬編程代理:

模型情境通訊協定(MCP)工具整合

透過 MCP 工具,AI Assistant 能夠與外部環境、資料庫、容器引擎及企業議題追蹤系統互相連動。

為確保系統安全性,開發人員必須在 Settings | Tools | AI Assistant 下明確設定資料庫權限:


第三方提供商與自訂模型(BYOK)

欲整合管理 AI 支出或運用內部模型閘道的企業組織,可利用自備金鑰 (BYOK)組態,將 AI Assistant 與 JetBrains 託管的雲端訂閱解耦。

設定第三方提供商

前往 Settings | Tools | AI Assistant | Providers & API keys:

  1. 點擊 Add Provider 並從支援的商業廠商中選取:
    • OpenAI:需要具備存取權限的 OpenAI 平台 API 金鑰,可使用 gpt-4o 或 o1 等模型。
    • Anthropic:需要支援 claude-3-5-sonnet 或 claude-3-opus 的 Anthropic API 金鑰。
    • Google Cloud Vertex AI:透過應用程式預設憑證(ADC)或服務帳戶金鑰進行身分驗證。
  2. 輸入認證金鑰並測試連線延遲。
  3. 為特定功能指派模型(例如:指派輕快模型處理內嵌程式碼自動完成,指派具備較強推理能力的模型用於 AI Chat 與重構)。

連線本機與自訂端點

針對隔離網路(Air-Gapped)環境或內部私有資料中心,開發人員可選用自訂模型:

+-------------------------------------------------------------+
|                      Local Workstation                      |
|                                                             |
|  +------------------------+      +-----------------------+  |
|  |     JetBrains IDE      |      |     Ollama Server     |  |
|  |  (AI Assistant Plugin) | ---> | (http://localhost:    |  |
|  |                        | <--- |  11434/v1)            |  |
|  +------------------------+      +-----------------------+  |
+-------------------------------------------------------------+
  1. 啟動對外提供相容於 OpenAI API 的本機推論伺服器(例如 Ollama、vLLM 或 LM Studio)。
  2. 在 Providers & API keys 下,新增 Custom OpenAI-Compatible 提供商。
  3. 設定 Base URL(例如 Ollama 的 http://localhost:11434/v1)並指定載入的模型識別代碼(例如 qwen2.5-coder:32b 或 deepseek-coder-v2)。
  4. 確認本機程式碼完成能正常串流匯入編輯器中,且不會有外部 WAN 流量流出。

資料治理、隱私安全與企業控管

在商業環境中部署 AI 編程助手需要透明的資料隱私維護與稽核保障機制。

資料傳輸與模型訓練邊界

JetBrains 在其官方說明文件與信任中心(Trust Center)中確立了嚴謹的資料處理原則:

企業防火牆、代理伺服器與 SSL 檢驗

在企業內部網路邊界運作的開發人員工作站必須放行對外安全通訊:

配額監控與停用選項

視窗標題列中的 JetBrains AI 狀態小工具能提供使用指標的即時資訊:

若開發人員需要暫停使用 AI Assistant,可透過小工具選單針對單一專案暫時停用相關功能、僅關閉雲端完成而保留本機整行代碼完成,或是在整個 IDE 安裝環境中完整解除安裝該外掛程式。