插件在 2026 年 6 月彻底不工作了,发生了什么?

如果你在 Code Assist for individuals、Google AI Pro 或 Google AI Ultra 档,Google 从 2026 年 6 月 18 日起停止为这些档位提供 IDE 扩展(和旧版 Gemini CLI)服务。迁移到 Google Antigravity 或 Antigravity CLI(`agy`)。Standard / Enterprise 许可不受影响。

为什么同样的模型版本,网页版感觉比插件聪明?

网页版能拿到更长的有效上下文,新快照 rollout 通常也更早;插件被 IDE 消息大小限制和更慢的发布节奏拖住。

chat 一口咬定自己是 Gemini 2.5,这是真的吗?

不是。Gemini 2.5 在 2026 年初已下线。看到它说明插件过期、模型路由被缓存、或 `settings.json` 里被强制设了 `gemini-3-pro-preview` 或旧默认——更新、重新登录、重新选模型即可。

我的 settings.json 老是被改回一个我删掉的项目,怎么止住?

这是一个已知回归([issue #1219](https://github.com/GoogleCloudPlatform/cloud-code-vscode/issues/1219))。关闭 IDE,从 `settings.json` 删掉 `geminicodeassist.project`,登出,重新打开,然后只通过状态栏的 `Switch Project` 选择器来设置项目。

登出会清掉 chat 历史吗?

不会。历史在服务端,重新登录后会回来,不过本地索引可能需要重建。

迁移到 Antigravity 会丢掉我的 Gemini CLI skills 和 hooks 吗?

不会。Antigravity CLI 保留了 Agent Skills、Hooks、Subagents、以及 Extensions(改名为 "Antigravity plugins"),不过发布初期不是完全 1:1 的功能对齐。

常见问题解决库

Gemini Code Assist IDE 插件和网页版模型不同步

VS Code 或 JetBrains 里的 Gemini Code Assist 插件感觉比 gemini.google.com 弱。截至 2026 年 6 月,原因往往是 Antigravity 迁移、插件过期、项目绑错,或索引卡住。

发布于: 2026/05/24 更新于: 2026/06/21 作者: AI Productivity Guide Team 🌐 查看英文版本

同一个问题,在 gemini.google.com 上能给你一个跨多个文件的干净答案,在 VS Code 或 JetBrains 的 Gemini Code Assist 插件里却变成一个单函数的幻觉答案。或者行内补全直接不再触发。又或者你切了 chat 模型,下一条回复还在说自己是 I am Gemini 2.5——这个模型 2026 年初就下线了。

先看这一条(截至 2026 年 6 月最大的原因)。 2026 年 6 月 18 日起,Google 不再通过 Gemini Code Assist IDE 扩展和旧版 Gemini CLI 为 Gemini Code Assist for individuals(免费个人版)、Google AI Pro(每月 $19.99)、Google AI Ultra(每月 $99.99) 这几档用户提供服务。如果你在这几档里,插件已经不再是合适的工具——你要迁移到 Google Antigravity(桌面应用,即 “Antigravity 2.0”)或 Antigravity CLI(agy 这个二进制)。迁移文档:antigravity.google/docs/gcli-migration。如果你所在的组织持有 Gemini Code Assist Standard 或 Enterprise 许可,插件照常可用,下面的重新同步步骤适用于你。

所以,在排任何错之前,先回答一个问题:

你的档位	IDE 插件还在服务吗?	怎么办
Code Assist for individuals(免费)	否,2026-06-18 起停	迁移到 Antigravity / Antigravity CLI
Google AI Pro($19.99)	否,2026-06-18 起停	迁移到 Antigravity / Antigravity CLI
Google AI Ultra($99.99)	否,2026-06-18 起停	迁移到 Antigravity / Antigravity CLI
Code Assist Standard / Enterprise	是	用下面的重新同步步骤
Code Assist for GitHub(企业版,走 Cloud)	是	不受影响(消费者版 GitHub 应用 2026-06-18 起停用)

如果你是 Standard/Enterprise 用户而插件仍然掉队,本文剩下的部分就是修法。Code Assist 跑的是和网页版同一系列的 Gemini,但 IDE 插件有自己的模型路由、自己的 Google Cloud 项目绑定、自己的上下文索引、自己的 auth 刷新周期。任何一个环节都可能掉队。

常见原因

按出现频率从高到低排。

1. 你在已停服的档位上(个人版 / AI Pro / AI Ultra)

这现在是头号原因。2026 年 6 月 18 日之后,这些档位上的插件要么直接报错,要么静默降级,要么把你卡在一个旧模型上而没有明确警告。再怎么重新登录都修不好,因为后端已经不再为这些档位提供服务。

怎么判断:打开插件的状态面板或 Settings,看你的订阅类型。如果显示的是 individual / AI Pro / AI Ultra(而不是 Standard 或 Enterprise),你就在已停服的档位上。迁移到 Antigravity。

2. 插件版本比模型发布晚好几个月

对仍在服务的档位来说,Google 大概每个月推一个新的 Gemini 快照,但插件更新慢一些,而且 IDE marketplace 还会缓存旧版本。落后几个小版本的插件可能还指向一个已下线的模型名,而 UI 上完全看不出来。

怎么判断:在 chat 里问 what model are you?。如果它报出的名字不在当前 Code Assist 的模型列表里(截至 2026 年 6 月,当前是预览中的 Gemini 3.1 Pro 和正式发布的 Gemini 3.5 Flash;Gemini 2.5 已下线),插件就是过期的。

3. 绑定到了错误的 Google Cloud 项目

Code Assist 通过一个 Google Cloud 项目计费和走配额。如果你有多个项目而插件挑错了,你可能在一个 Code Assist API 被禁用的项目上、或者配额耗尽、或者模型列表被组织策略限制。

怎么判断:点 Cloud Code 状态栏里当前的项目名,再选 Switch Project。如果当前绑的不是你想要的,就是这个问题。Output 面板的 “Cloud Code” 段里出现配额错误也是信号。

4. 插件反复把过期的项目和模型强行写回 settings.json

有一个已知的回归问题(记录在 cloud-code-vscode issue #1219):扩展会反复重写 settings.json,把一个已废弃的 geminicodeassist.project 项目 ID 重新塞回去,并把模型默认回 gemini-3-pro-preview,哪怕你删掉这些行并重启也一样。受影响的用户试过关闭 Settings Sync、清空 settings.json、重装扩展,都没能阻止它。

怎么判断:编辑 settings.json,删掉 geminicodeassist.project,重启 IDE,再打开 settings.json——如果旧项目 ID 和 gemini-3-pro-preview 自己又冒出来了,你就中了这个 bug。

5. 上下文索引卡住或被禁用

本地代码库感知依赖一个后台索引扫描你的 workspace。如果你打开了一个大 monorepo 而索引从没跑完——或者你在隐私设置里把它关了——模型就拿不到项目上下文,只能用 prompt 里那点信息回答。(代码自定义大约每 24 小时重建一次索引。)

怎么判断:问它 where is the function that handles login?。如果它泛泛回答 “通常你会在 auth.js 里找到”,而不是引用你真实的文件路径,索引就没在工作。

6. Auth token 静默过期

OAuth token 可能在没有清晰提示的情况下过期。插件用过期 token 重试,收到 401,回退到一个更小的缓存模型或者直接返回空响应。Chat 窗口看起来只是慢或者没反应。

怎么判断:Output 面板出现 401 或 UNAUTHENTICATED。或者用了几个小时之后,行内 ghost-text 建议突然不再出现。

7. chat 里选了错误的模型

chat 有自己的模型选择器,和网页版的选择器是分开的。Gemini 3 可用时会被自动选中,但手动选择(或设置同步)可能把你留在一个 Flash 变体上,而你预期的是 Pro。

怎么判断:打开 chat 输入框上的模型选择器。如果它是某个 Flash 变体而你预期是 Gemini 3.1 Pro,就切过去。

8. 区域 / 数据驻留限制

Workspace 和 Cloud 账号可能受数据驻留策略限制(欧盟、日本、印度)。如果你的账号被锁在一个最新 Gemini 快照还没推送到的区域,插件就会路由到那个区域里的旧快照,而且没有任何可见警告。

怎么判断:同一个插件版本,在没受限的同事账号上表现更好。检查你的 Admin Console / Cloud 组织策略里有没有区域锁。

9. 本地代理或 VPN 把流式传输切了

公司代理和某些 VPN 会干扰流式协议。插件在响应中途看起来 “卡住”,然后等缓冲一次性刷下来才打出半段答案。看起来像模型问题,其实是网络问题。

怎么判断:同一个查询,切换到手机热点上能流畅出字。Output 面板可能出现超时或 connection reset。

最短修复路径

Step 0: 确认你的档位还在服务

如果你在 individual / AI Pro / AI Ultra 档,到这里就别往下了——插件不会变好。装上 Antigravity(Antigravity 2.0 桌面应用)或 Antigravity CLI(agy),按 antigravity.google/docs/gcli-migration 迁移。你的 chat 历史和 skills 会带过去;agent skills、hooks、subagents、以及 extensions(现在叫 “Antigravity plugins”)都保留。下面的步骤是给 Standard / Enterprise 用户的。

Step 1: 更新插件和 IDE

VS Code:Extensions → Gemini Code Assist → 检查更新,然后 Reload Window。JetBrains:Settings → Plugins → Updates。同时把 IDE 本身也升级——Code Assist 会指定一个最低 IDE 版本。更新完之后,彻底重启 IDE(不只是 reload 窗口),清掉内存里的模型缓存。

Step 2: 确认绑定的项目和 API 启用情况

点 Cloud Code 状态栏里的项目名 → Switch Project → 选你想要的那个。然后到 Google Cloud Console 确认两个 API 都已启用:

APIs and Services → Enabled APIs
- cloudaicompanion.googleapis.com  (Code Assist)
- aiplatform.googleapis.com        (Vertex AI)

任意一个缺,启用它,然后等约 5 分钟让 IAM 生效。

Step 3: 如果项目反复被写回,干净地清掉它

如果你中了强制项目的 bug(原因 4),把下面这些一次性做完,而不是一项一项试:

关闭 IDE。
编辑 settings.json,删掉 geminicodeassist.project 以及任何 geminicodeassist.subscriptionType 的覆盖项。
登出:命令面板 → Cloud Code: Sign Out(或 Sign out of all accounts in Google Cloud SDK)。
重新打开 IDE,登录回来,然后只通过状态栏的 Switch Project 设置一次项目,别手动改文件。

对受影响的用户来说,通过选择器(而不是改文件)设置才是能留住的方式。

Step 4: 强制重新登录

VS Code:命令面板 → Cloud Code: Sign Out,然后 Cloud Code: Sign In。JetBrains:Tools → Google Cloud Code → Sign out,再登录。重新登录会同时刷新 OAuth token 和模型路由握手,出乎意料地能修好一大堆 “整体感觉不对” 的报告。

Step 5: 重置本地索引

命令面板 → Cloud Code: Reset Local Index

对大 monorepo,在仓库根加一个 .aiexclude 文件(语法和 .gitignore 类似,但要注意它不支持 ! 取反),列出要跳过的目录:

node_modules/
dist/
build/
.git/
vendor/

几千个文件的索引几分钟就完;几万个不做排除会慢得多,而且可能静默放弃。注意空的或不存在的 .aiexclude 不会屏蔽任何东西。

Step 6: 显式设置 chat 模型

打开 chat 输入框上的模型选择器,处理更难的推理时选 Pro 档(Gemini 3.1 Pro),而不是某个 Flash 变体。在 VS Code 的 agent mode 里模型是自动选的;如果你需要手动控制 agent mode 的模型,用 JetBrains 插件,它把这个选项暴露了出来。

Step 7: 确认修好了

重新同步之后,跑两个快速探针:

模型探针:在 chat 里问 what is your exact model identifier?,确认它和选择器一致(一个当前的 Gemini 3.x 名字,不是 2.5)。
上下文探针:问 list the top-level directories in this workspace.。如果答得对,索引是健康的。

如果两个都过,而一个针对真实文件的问题现在能返回你真实的路径,你就重新同步好了。

Step 8: 如果是区域锁,升级给管理员

如果你所在组织有数据驻留策略把你锁在一个落后于最新快照的区域,表现就不在你手上了。给你的 Workspace / GCP 管理员开 ticket,根据策略要求换区域或申请例外。

这种情况不怪你

Google 偶尔会因为容量原因把 Code Assist 用户 A/B 路由到不同模型变体,尤其是新快照刚 rollout 的那几天。如果你这边没改动、质量却一天一变,那就是路由波动,通常大版本发布后一周内会稳定下来。marketplace 缓存也不在你控制之内——VS Code marketplace 发布后偶尔会有几天提供稍微过期的插件副本。

容易被误诊为

得出 “Gemini 写代码就是不行” 的结论。同一个模型,从 gemini.google.com、Vertex AI Studio、或者 API 直接访问,通常都明显更好,这就说明瓶颈在集成层,不在模型能力。如果你能在网页上复现失败但在插件里复现不了(或者反过来),就把调查聚焦到失败的那一侧。

也很容易把 Code Assist 和老的 AI Studio 插件、第三方 Gemini IDE 插件、现在还有 Antigravity 搞混。排错之前先弄清楚你实际跑的是哪个工具。

预防

搞清楚自己的档位。individual / AI Pro / AI Ultra 用户本就该在 Antigravity 上了;只有 Standard / Enterprise 才应该继续依赖插件。
把插件设为自动更新;每月 Google 推快照时复查一下版本。
给 Code Assist 固定一个 Google Cloud 项目,团队内部文档化是哪一个。
维护一个 .aiexclude 文件,避免索引被 node_modules 或构建产物拖死。
任何 IDE 大版本升级后,彻底重启并重新登录一次。
收藏一个 Code Assist release notes 链接,方便核对当前模型名。

FAQ

插件在 2026 年 6 月彻底不工作了,发生了什么? 如果你在 Code Assist for individuals、Google AI Pro 或 Google AI Ultra 档,Google 从 2026 年 6 月 18 日起停止为这些档位提供 IDE 扩展(和旧版 Gemini CLI)服务。迁移到 Google Antigravity 或 Antigravity CLI(agy)。Standard / Enterprise 许可不受影响。
为什么同样的模型版本,网页版感觉比插件聪明? 网页版能拿到更长的有效上下文,新快照 rollout 通常也更早;插件被 IDE 消息大小限制和更慢的发布节奏拖住。
chat 一口咬定自己是 Gemini 2.5,这是真的吗? 不是。Gemini 2.5 在 2026 年初已下线。看到它说明插件过期、模型路由被缓存、或 settings.json 里被强制设了 gemini-3-pro-preview 或旧默认——更新、重新登录、重新选模型即可。
我的 settings.json 老是被改回一个我删掉的项目,怎么止住? 这是一个已知回归(issue #1219)。关闭 IDE,从 settings.json 删掉 geminicodeassist.project,登出,重新打开,然后只通过状态栏的 Switch Project 选择器来设置项目。
登出会清掉 chat 历史吗? 不会。历史在服务端,重新登录后会回来,不过本地索引可能需要重建。
迁移到 Antigravity 会丢掉我的 Gemini CLI skills 和 hooks 吗? 不会。Antigravity CLI 保留了 Agent Skills、Hooks、Subagents、以及 Extensions(改名为 “Antigravity plugins”),不过发布初期不是完全 1:1 的功能对齐。