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-cliGemini CLI 是运行在终端里的开源 AI 智能体。这篇文章只做一件事讲清楚 VS Code 集成——怎么装、怎么确认它真的活着、它是怎么看见你的编辑器的、它提议的改动又怎么在编辑器里审查。读完后你能用 3 分钟完成 IDE 集成安装并像审 PR 一样在原生差异视图里审 AI 写的代码。痛点AI 只能看见你贴给它的东西不装集成的时候Gemini CLI 像一个隔着墙帮你改代码的人它只能看见你复制粘贴过去的片段。你在auth.ts里发现一个 bug它的建议是一整段文本你得自己找到对应行手工贴回去你编辑器里正开着utils.ts它不知道你手动补的上下文永远差几行。更烦的是改完之后你只能盯着两块文本自己肉眼比对。VS Code 集成干的就是这件事给 CLI 装上一双眼睛和一只手。选一条安装路线3 分钟装好 IDE 集成三条路线摆一起看适合谁怎么装坑多不多第一次用就在 VS Code 集成终端里直接跑gemini按提示回答 Yes全自动最少扩展装好且连接一步到位错过提示想自己装一次在 CLI 里敲/ide install少但编辑器不在自动安装名单时要退回市场想挑版本或者用 VS Code 的分支编辑器扩展市场装 Gemini CLI Companion稍多装完还得在 CLI 里跑一次/ide enable推荐第一条。Gemini CLI 在受支持的编辑器VS Code 以及 Antigravity 等兼容编辑器里运行时会自己检测环境发现没装 companion 扩展就会当场提示你。回答Y之后它下载并安装扩展、注入连接所需的环境变量、拉起 IDE 服务器全程不用你动手。另外两条各一句话/ide install给错过提示的人在 CLI 里补装市场安装给要挑版本或用 VS Code 分支编辑器的人分支编辑器走 Open VSX 仓库。手动装完必须在 CLI 里跑/ide enable才会真正点亮。装完怎么确认连接还活着 在 VS Code 里开个新终端启动gemini输入/ide status看到类似这样的输出就通了Connected to Visual Studio Code Open files: - src/auth.ts (active) - package.json它会列出当前连的 IDE 和工作区里最近打开的若干文件这就是眼睛张开的证据。红灯别慌对表症状解法连不上 IDE companion extension确认扩展已安装并启用然后开个新终端再跑老终端里没有那两个环境变量目录不匹配Directory mismatchcd到 VS Code 打开的那个文件夹重启 CLI两边必须一致提示没有可用的安装器这个编辑器没有自动安装器去市场装 Gemini CLI Companion再跑/ide enable还有一种容易被忽略的情况VS Code 没打开任何工作区扩展手里没有东西可上报连接自然失败。先开一个文件夹再试。AI 是怎么看见你的工作区的 ️连接建立后VS Code 端的 companion 扩展就像一双盯着你编辑器的眼睛。切换文件、移动光标、选中一段文字这些动作都会触发状态快照扩展通过本地服务器推给 CLICLI 再把快照并进给模型的上下文。信息分三类各有上限送什么上限说明最近打开的文件10 个只统计磁盘上的本地文件活动文件排最前光标位置仅活动文件行列坐标随你移动实时更新选中文本16KB超出的部分会被截断这就是集成之后你能不贴文件路径、只说把这个函数修一下的原因——它已经在场知道你正盯着哪个文件的哪一行。改动落在编辑器里原生差异视图怎么审Gemini CLI 提议修改文件时它不往外吐一大段文本而是直接在 VS Code 里打开一个 diff。注意这是编辑器的原生差异视图左右分栏、逐行对照、带语法高亮不是终端里的两坨纯文本。整个循环走 4 步CLI 生成改动请求打开差异视图VS Code 弹出 diff 编辑器左边是原文件右边是建议你逐行看还能直接在右边编辑把建议改成你想要的样子接受点标题栏对勾、按CtrlS/CmdS保存、或在 CLI 里答yes拒绝点 X、关掉标签页、或答no。CLI 会收到你的接受/拒绝结果再继续后续动作。命令面板里还有Gemini CLI: Accept Diff和Gemini CLI: Close Diff Editor两个现成命令。嫌每次都确认麻烦可以在 CLI 里选Allow for this session之后的改动直接落盘跳过差异视图。配置速查环境变量与 settings.json ⚙️连接依赖扩展启动时注入的两个环境变量你平时不用碰它们名称作用默认值GEMINI_CLI_IDE_WORKSPACE_PATH扩展上报给 CLI 的工作区路径扩展自动注入GEMINI_CLI_IDE_SERVER_PORT扩展 IDE 服务器的本地端口自动分配GEMINI_CLI_IDE_PID手动指定 IDE 进程号跳过自动检测未设置自动检测失败时——比如你在独立终端里跑 CLI——把GEMINI_CLI_IDE_PID指到 IDE 的 PID 上它会绕过探测直连那台实例。配置文件这边真正要动手的只有一个字段放在 ~/.gemini/settings.json字段作用默认值ide.enabledIDE 集成模式总开关falseide.hasSeenNudge是否已看过安装提示false/ide enable和/ide disable等价于临时切换ide.enabled改完需重启生效。完整行为可以看官方文档 docs/ide-integration/index.md扩展源码在 packages/vscode-ide-companion/src文件监控和差异管理的逻辑都在这儿排查问题时可以翻一眼。两种特殊环境的坑提前说CLI 跑在 Docker/Podman 容器里时依然能连上宿主机上的 VS Code 扩展它会通过host.docker.internal自动找到 IDE 服务器macOS 上用 Seatbelt 沙箱的话得放行网络访问的 profile否则连不上。团队怎么用共享配置把.gemini/settings.json提交进仓库全队用同一套模型与 MCP 服务配置审查脚本gemini -p配一段固定提示词生成标准化的审查报告CI 接入流水线里装好 CLI每次 pull request 自动跑一遍审查。一条就能试在仓库根目录执行gemini -p 审查本次改动指出正确性、风格和安全问题。接通之后集成是个开关不是门槛。/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），仅供参考