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 设置（
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。
