cloud code 插件需同时满足gcloud认证、项目配置、vscode功能开关三者对齐才能正常工作；常见问题如按钮灰掉、无响应等均源于这三环未同步，须逐一验证并重置skaffold二进制。
Cloud Code 插件不是装上就能用的，它必须和本地 gcloud CLI 的认证状态、项目上下文、以及 VSCode 的功能开关三者对齐，缺一不可。常见“部署按钮灰掉”“Refresh Credentials 无反应”“Deploy to Cloud Run 不弹选项”，基本都卡在这三环里。
确认 gcloud CLI 已登录且项目已设为默认
VSCode 内所有 Cloud Code 操作最终都调用系统级 gcloud 命令，如果终端里都跑不通，插件必然失效。
- 在 VSCode 内置终端（或系统终端）运行
gcloud auth list，检查 ACTIVE 列是否有带星号的账户；若为空或显示 EXPIRED，必须重登：gcloud auth login --update-adc - 执行
gcloud config get-value project确认返回的是你目标项目 ID；如果不是，立刻设置：gcloud config set project YOUR_PROJECT_ID - 重启 VSCode 或至少重开内置终端——VSCode 启动时只读取一次 PATH 和环境变量，
gcloud配置变更后不重启终端，插件看不到新状态
启用 Cloud Code 的关键功能开关
插件默认关闭部分高阶能力，比如 Cloud Run 调试、Kubernetes 支持，需手动开启，否则右键菜单里压根不会出现对应项。
VSCode 1.118
下载
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
- 打开 VSCode 设置（
Cmd+,或Ctrl+,），搜索cloudcode.enableCloudRunSupport并勾选 - 同理启用
cloudcode.enableKubernetesSupport（即使你只用 Cloud Run，Skaffold 编排也依赖它） - 如涉及 App Engine，再启用
cloudcode.enableAppEngineSupport - 这些开关不重启 VSCode 也能生效，但建议改完顺手执行一次
Cloud Code: Reset Skaffold Binary（命令面板输入）
避免用错插件：Google Cloud ≠ Cloud Code
VSCode 扩展市场里有两个名字近似的官方插件，功能定位完全不同，装错一个就全链路断掉。
- “Google Cloud” 插件（发布者 Google LLC）：仅提供资源浏览、Cloud Shell 集成、基础部署，**不支持本地模拟器、热重载、调试器附加**
- “Cloud Code” 插件（发布者 Google LLC）：才是完整开发闭环工具，含
Run on Cloud Run Emulator、Debug on Cloud Run、自动生成skaffold.yaml等能力 - 两者可共存，但如果你要本地调试或一键部署，必须装的是后者；卸载前者不影响后者功能
多项目切换时，别只靠 gcloud config
当你在多个 GCP 项目间来回切换，仅靠 gcloud config set project 容易导致 VSCode 侧边栏显示旧项目资源，或部署时仍打到上一个项目。
- 在命令面板中运行
Cloud Code: Select Project，从列表中显式选择当前工作区目标项目 - 更稳妥的做法是在工作区根目录的
.vscode/settings.json中硬编码绑定："cloudcode.projectId": "my-dev-project" - 该配置优先级高于
gcloud全局设置，能防止误操作污染其他项目环境
最常被忽略的是 Skaffold 二进制状态——它不报错，只是静默失败。只要部署卡在 “Building image…” 或命令无响应，第一反应不是重装插件，而是先执行 Cloud Code: Reset Skaffold Binary。
