☰
Gemini CLI × VS Code 集成实战:3 分钟接通编辑器,告别终端里盲改代码
2026/10/25 18:58:54 网站建设 项目流程

Gemini CLI × VS Code 集成实战:3 分钟接通编辑器,告别终端里盲改代码

【免费下载链接】gemini-cliAn open-source AI agent that brings the power of Gemini directly into your terminal.项目地址: https://gitcode.com/GitHub_Trending/gemi/gemini-cli

Gemini CLI 是跑在终端里的开源 AI 智能体,它的 VS Code 集成负责装上一双眼睛和一只手:看你在改哪个文件、选了什么,并把建议的改动直接摊进编辑器的原生差异视图。读完你能用 3 分钟完成安装,再敲 1 条命令确认连接真的活着,全程不查文档。

不接通 VS Code 的代价:AI 只能看见你贴的东西

不装集成时,Gemini CLI 像隔着墙帮你改代码的人:你在auth.ts里发现一个 bug,它的建议是一整段文本,你得自己找到对应行贴回去;你编辑器里正开着utils.ts,它不知道;你手动补的上下文,永远差几行。

改完更烦——你得盯着终端和编辑器里两块文本,肉眼逐行比对。

选最快的接入路线:3 种装法一张表对比

适合谁怎么做代价
第一次用,就在 VS Code 集成终端里直接跑gemini,提示出现时答 Yes最少,扩展和连接一步到位
错过提示,想自己补装在 CLI 里敲/ide install少;编辑器不在自动安装名单时要退回市场手动装
要挑版本,或用 VS Code 分支编辑器扩展市场装 "Gemini CLI Companion"稍多,装完还得跑/ide enable才真正点亮

推荐第一条:Gemini CLI 在 VS Code(及 Antigravity 等兼容编辑器)里运行时会自动检测环境,发现没装 companion 扩展就当场提示你。答Y之后它自己下载扩展、注入连接所需的环境变量、拉起 IDE 服务器,全程不用你动手。

跑一条命令确认连接还活着

在 VS Code 里开个新终端,启动gemini,输入:

/ide status

看到这样的输出就通了:

Connected to Visual Studio Code Open files: - src/auth.ts (active) - package.json

它会列出当前连的 IDE 和工作区里最近打开的文件,这就是"眼睛"张开的证据。红灯别慌,对表排查:

症状解法
连不上 IDE companion extension确认扩展已安装并启用,然后开个新终端再跑(老终端里没有那两个环境变量)
目录不匹配(Directory mismatch)cd到 VS Code 打开的那个文件夹,重启 CLI,两边必须一致
提示没有可用的安装器这个编辑器没有自动安装器,去市场装 "Gemini CLI Companion",再跑/ide enable
提示要 open a workspace folderVS Code 没开任何文件夹,先开一个再试

看懂 AI 是怎么看见你的工作区的 👁️

连接建立后,VS Code 端的 companion 扩展像一双盯着你编辑器的眼睛。切换文件、移动光标、选中文字,这些动作都会触发状态快照,扩展通过本地服务器推给 CLI,CLI 再把它并进给模型的上下文。送什么、送多少,各有上限:

送什么上限说明
最近打开的文件10 个只统计磁盘上的本地文件,活动文件排最前
光标位置仅活动文件行列坐标,随你移动实时更新
选中文本16KB超出的部分会被截断

这就是集成之后你能不贴文件路径、只说"把这个函数修一下"的原因——它已经在场,知道你正盯着哪个文件的哪一行。

配置速查:环境变量与两个开关字段

连接依赖扩展启动时自动注入的环境变量,你平时不用碰它们。真正要动手的只有 settings.json 里的字段(放在~/.gemini/settings.json):

名称类型作用默认值
GEMINI_CLI_IDE_WORKSPACE_PATH环境变量扩展上报给 CLI 的工作区路径,自动注入自动
GEMINI_CLI_IDE_SERVER_PORT环境变量扩展 IDE 服务器的本地端口自动分配
GEMINI_CLI_IDE_PID环境变量手动指定 IDE 进程号,跳过自动检测直连未设置
ide.enabledsettings.jsonIDE 集成总开关,/ide enable和/ide disable等价于临时切换它false
ide.hasSeenNudgesettings.json是否已看过安装提示false

两种特殊环境的坑提前说:CLI 跑在 Docker/Podman 容器里时,依然能连上宿主机上的 VS Code 扩展,它会通过host.docker.internal自动找到 IDE 服务器;macOS 上用 Seatbelt 沙箱的话,得放行网络访问的 profile,否则连不上。

完整行为看 docs/ide-integration/index.md;扩展源码在 packages/vscode-ide-companion/src/,文件监控和差异管理的逻辑都在这儿,CLI 侧的连接检测在 packages/core/src/ide/,排查问题时可以翻一眼。

团队怎么用:3 条能直接抄的玩法

  • 共享配置:把.gemini/settings.json提交进仓库,全队用同一套模型与 MCP 服务配置;
  • 审查脚本:gemini -p "审查本次改动,指出正确性、风格和安全问题",生成标准化的审查报告;
  • CI 接入:流水线里装好 CLI,每次 pull request 自动跑一遍同一命令。

接通之后

集成是个开关,不是门槛。/ide status跑绿了,差异审查、上下文、团队玩法就都在手边了。下一步:在 VS Code 里选中一个函数,直接告诉 Gemini CLI 去改。

【免费下载链接】gemini-cliAn open-source AI agent that brings the power of Gemini directly into your terminal.项目地址: https://gitcode.com/GitHub_Trending/gemi/gemini-cli

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询