广告位招商中 欢迎洽谈
简体中文
English简体中文繁體中文日本語EspañolPortuguês한국어DeutschFrançais
全网站点

在主流 IDE 中启用与配置 JetBrains AI Assistant 实战指南

指南
365Finds Editorial
已收录 11,430 篇 Wiki 文章

让你的 AI 用上 365 Wiki

复制这段快捷提示词，粘贴到你正在使用的 AI 对话中，然后继续提问。AI 会搜索 365 Wiki，帮你查资料、比较方案并给出建议。

下载完整 Skill

偶尔使用，快捷提示词就够了。经常使用，安装 365Wiki Skill：无需每次复制，还能更完整地研究问题、比较选择并规划下一步。没有常用工具？Gemini、Microsoft Copilot 等网页版 AI 也能使用。

365Wiki Skill

下载完整 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. 

  2. 如果组织实施了严格的知识产权治理或安全合规策略，管理员可在开发者初始化激活前分配共享点数池或指定已批准的第三方供应商。
    3. 





安装与激活 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. 

  2. AI Chat 工具窗口：

      

    • 点击右侧工具窗口停靠栏中的 AI Chat 图标。
      • 

    • 点击空工具窗口中显示的 Install Plugin 按钮，触发后台静默安装。
      • 

    

    3. 

  3. JetBrains AI 窗口标题栏小组件：

      

    • 在现代 IDE 界面标题栏中，找到 JetBrains AI 状态小组件。
      • 

    • 点击 Let's Go，即可自动下载并初始化插件。
      • 

    

    4. 



许可证层级与激活场景


安装完成后，开发者必须使用相应的许可模式激活插件。JetBrains 在激活场景下支持多种身份验证方式：











































激活方式需要订阅可用功能主要计费实体
JetBrains AI 订阅是（Free、Pro、Business、Ultimate、Enterprise）完全访问所有云端模型、内置 Agent、内联代码补全及后续修改建议JetBrains（每月配额或企业共享点数池）
自带密钥（BYOK）否（使用第三方 API 密钥）所选第三方模型支持的内联补全和聊天功能第三方供应商（OpenAI、Anthropic、Google Vertex AI）
供应商账户（OAuth）否（通过供应商 OAuth 登录）仅限所认证 Agent 的专用访问权限（例如 Claude Agent、GitHub Copilot）专用 Agent 供应商
ACP 兼容 Agent否通过 Agent Client Protocol 与自定义外部 Agent 对接独立 Agent 供应商
本地 / 自定义模型否本地运行的推理服务器所支持的功能（例如 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）和提交信息均以所需的工作语言生成。


消息裁剪阈值（Message Trimming Threshold）


在处理庞大代码库时，附加多个源文件可能会迅速耗尽大上下文窗口。在 Settings | Tools | AI Assistant 下，开发者可以配置 Message Trimming Threshold（以模型总上下文窗口的百分比表示）。如果附加的数据载荷超过此阈值，AI Assistant 会自动裁剪外层非关键结构，同时保留相关的函数签名和调用点，从而避免超出上下文窗口的 Token 溢出异常。




配置编辑器内代码补全与后续修改建议


JetBrains IDE 针对代码补全采用了双引擎架构：本地设备端补全与远程云端补全。


本地整行补全与云端多行补全对比


理解不同补全机制的区别对于实现最优配置至关重要：


    

  1. 整行代码补全（Full Line Code Completion）：完全在开发者工作站本地运行，采用随 IDE 直接打包的轻量级特定语言神经网络模型。它完全离线执行，网络延迟为零，不消耗 AI 点数，也不会将代码传出本地机器。
    2. 

  2. 云端代码补全（Cloud Code Completion）：由 AI Assistant 云端大模型驱动。它根据更广阔的文件上下文生成多行代码结构、完整方法体、算法逻辑以及附带的文档注释。
    3. 



配置内联补全参数


要微调内联补全，请导航至 Settings | Editor | General | Code Completion | Inline：



按键快捷键与采纳控制


可以使用标准快捷键采纳或关闭内联虚影建议：





AI Chat、上下文管理与项目规则


AI Chat 工具窗口充当交互式结对编程环境，能够跨文件、堆栈跟踪和项目历史进行推理。


使用 Mention 引用上下文


开发者无需在聊天输入框中手动复制粘贴源代码片段，而是应使用 @ 符号提供精准的上下文引用：



使用 /docs 检索官方文档


需要 IDE 使用指导的开发者可以在聊天提示中直接使用 /docs 命令查询 JetBrains 官方文档。例如输入：


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



此命令将对 JetBrains 官方产品文档触发检索增强生成（RAG）查询，返回操作规范指引，并附带可直接跳转至 IDE 设置对话框的深层链接。


自定义提示词库（Prompt Library）


团队通常需要反复执行特定架构模式，例如创建仓储类、构建 HTTP 客户端 Mock 或迁移旧版框架。开发者可以通过 Settings | Tools | AI Assistant | Prompt Library 将这些提示词标准化：


    

  1. 点击添加（+）按钮创建新的自定义提示词模板。
    2. 

  2. 定义描述性标题（例如 Generate Spring Data JPA Repository）。
    3. 

  3. 输入模板文本，使用 $SELECTION 等动态占位符指代选中的代码。
    4. 

  4. 将该提示词添加到编辑器上下文菜单中，实现一键快速调用。
    5. 



通过项目规则强制规范（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 并将其约束条件追加至该仓库内派发的所有提示词中，从而确保生成的代码严格符合团队规范。




编码 Agent、ACP 与模型上下文协议（MCP）


最新版本的 JetBrains AI Assistant 已经从被动的代码补全建议拓展到主动、自主的 Agent 工作流。


自主编码 Agent


在 Settings | Tools | AI Assistant | Agents 下，开发者可以配置专门的编码 Agent：



模型上下文协议（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. 

  2. 输入认证凭据并测试连接延迟。
    3. 

  3. 为不同功能角色分配模型（例如：分配轻量快速模型用于内联代码补全，分配具有更强推理能力的大模型用于 AI Chat 和重构）。
    4. 



连接本地与自定义端点


针对隔离网络环境（Air-Gapped）或私有数据中心，开发者可以选择使用自定义模型：


+-------------------------------------------------------------+
|                      Local Workstation                      |
|                                                             |
|  +------------------------+      +-----------------------+  |
|  |     JetBrains IDE      |      |     Ollama Server     |  |
|  |  (AI Assistant Plugin) | ---> | (http://localhost:    |  |
|  |                        | <--- |  11434/v1)            |  |
|  +------------------------+      +-----------------------+  |
+-------------------------------------------------------------+



    

  1. 启动暴露兼容 OpenAI API 的本地推理服务器（如 Ollama、vLLM 或 LM Studio）。
    2. 

  2. 在 Providers & API keys 下，添加 Custom OpenAI-Compatible 供应商。
    3. 

  3. 配置 Base URL（例如 Ollama 的 http://localhost:11434/v1）并指定已加载的模型标识符（如 qwen2.5-coder:32b 或 deepseek-coder-v2）。
    4. 

  4. 验证本地代码补全能够顺畅流式推送到编辑器中，且无外部 WAN 流量外发。
    5. 





数据治理、隐私合规与企业管控


在商业环境中部署 AI 编程助手需要透明的数据隐私保护和审计屏障。


数据传输与模型训练边界


JetBrains 在其官方文档和信任中心（Trust Center）中明确界定了数据处理边界：



企业防火墙、代理与 SSL 检查


在企业安全边界内运行的开发者工作站必须放行出站安全通信：



配额监控与停用选项


窗口标题栏中的 JetBrains AI 状态小组件提供了使用指标的实时可见性：



如果开发者需要停用 AI Assistant，可通过小组件菜单临时为单个项目禁用该功能、仅关闭云端补全而保留本地整行代码补全，或者在整个 IDE 安装环境中彻底卸载该插件。
涉及产品
JetBrains AI