手把手教你把 Gemini CLI 塞进 IntelliJ IDEA：ACP 集成指南

🎯 先说人话：这玩意儿能干啥？

想象一下这个场景：

你正在 IDEA 里疯狂敲代码，突然卡壳了。以前你得：切终端 → 打开 Gemini CLI → 复制代码 → 粘贴 → 等回复 → 再切回 IDEA。
现在？直接在 AI Assistant 聊天框里@Gemini，它就能看懂你的项目、帮你改代码、甚至跑终端命令！✨

这就是 Agent Client Protocol (ACP) 的魔法：让外部 AI 代理（比如 Gemini CLI）直接"住进"你的 IDE，无缝协作。

📋 前置条件（别跳过，否则踩坑别怪我）

🔧 四步走，集成搞定！

Step 1️⃣：安装 Gemini CLI（如果还没装）

npm install -g @google/gemini-cli

装完验货：

gemini --version
# 看到版本号？恭喜，第一步拿下！✅

💡 小贴士：如果权限报错，试试加 sudo（Mac/Linux）或用管理员身份运行终端（Windows）。

Step 2️⃣：找到 gemini 可执行文件的"真实住址"

ACP 配置需要绝对路径，不能玩"我以为你知道"的游戏。

🍎 macOS / 🐧 Linux 用户：

which gemini
# 示例输出：/Users/yourname/.nvm/versions/node/v22.16.0/bin/gemini

🪟 Windows 用户：

where gemini
# 示例输出：C:\Program Files\nodejs\gemini.cmd

⚠️ 重点：把这个路径复制好，马上要用！如果用 nvm，确保路径指向当前激活的 Node 版本，不然 IDEA 会一脸懵：“这文件呢？”

Step 3️⃣：配置 ACP 的"户口本" —— acp.json

JetBrains IDE 会去固定位置找这个配置文件：

新建或编辑文件，填入以下内容（记得替换 command 里的路径！）：

{
  "agent_servers": {
    "Gemini CLI": {
      "command": "/你的/实际/路径/gemini",
      "args": [
        "--experimental-acp"
      ],
      "use_idea_mcp": true,
      "use_custom_mcp": true
    }
  }
}

🔍 配置项逐行解读：

🤔 深度思考：为什么叫 experimental？
因为 ACP 协议还在演进中，未来可能有 breaking changes。生产环境使用建议先在小项目试水，别一上来就让它重构核心模块（血泪教训预警⚠️）。

Step 4️⃣：重启 IDEA，召唤 Gemini！

1. 重启 IntelliJ IDEA（配置生效的仪式感）
2. 打开 AI Assistant 面板（通常在右侧工具栏）
3. 找到 Agent 选择器（下拉菜单或 ⋯ 更多按钮）
4. 选择 “Gemini CLI”

🎉 看到聊天框里出现 Gemini CLI 标识？恭喜，集成成功！

📦 附：一键配置脚本（懒人福利）

macOS / Linux 用户，复制粘贴这条命令，自动创建 acp.json（记得先改路径！）：

mkdir -p ~/.jetbrains && cat > ~/.jetbrains/acp.json << 'EOF'
{
  "agent_servers": {
    "Gemini CLI": {
      "command": "$(which gemini)",
      "args": ["--experimental-acp"],
      "use_idea_mcp": true,
      "use_custom_mcp": true
    }
  }
}
EOF