Cloud Code插件必须与gcloud认证、项目配置、VSCode功能开关三者对齐才能正常工作；装错插件（如仅装Google Cloud插件）、未执行gcloud auth login和config set project、未启用cloudcode.enableCloudRunSupport等开关，均会导致部署按钮灰掉、调试不可用等问题。
装错插件或没对齐 gcloud 状态，VSCode 就根本连不上 GCP —— 不是插件问题，而是本地 CLI 认证、项目上下文、VSCode 功能开关三者没同步。
Cloud Code 插件必须装，Google Cloud 插件不能替代它
“Google Cloud”插件（发布者 Google LLC）只提供资源浏览和基础部署，Google Cloud: Deploy Function 这类操作不支持本地模拟器、热重载或调试；真正要跑 Debug on Cloud Run 或 Run on Cloud Functions Emulator，必须装的是 Cloud Code 插件。
两者可共存，但如果你点开命令面板搜不到 “Debug” 或 “Emulator”，八成是装错了。卸载前者不影响后者，建议只留 Cloud Code。
gcloud auth login 和 gcloud config set project 必须在终端里手动跑完
VSCode 不会帮你登录或选项目，它只读取当前 gcloud 配置。常见报错如：
ERROR: (gcloud.beta.run.deploy) You do not currently have an active account selected.- 部署成功但打到错误项目（比如上个月用的
demo-project）
执行顺序不能错：
-
gcloud auth login --update-adc（加--update-adc避免 ADC 过期） gcloud config set project YOUR_PROJECT_ID-
gcloud services enable run.googleapis.com（Cloud Run 必开） - 重启 VSCode 内置终端（或整个 VSCode），否则新配置不生效
cloudcode.enableCloudRunSupport 这类开关必须手动打开
插件默认关闭高阶功能，右键菜单里压根不会出现 Deploy to Cloud Run 或 Debug on Cloud Run，除非你主动启用：
- 打开设置（
Cmd+,或Ctrl+,），搜索cloudcode.enableCloudRunSupport并勾选 - 同理启用
cloudcode.enableKubernetesSupport（Skaffold 编排依赖它） - 改完后建议执行一次
Cloud Code: Reset Skaffold Binary（命令面板输入）
这些开关不重启 VSCode 也能生效，但 Skaffold 二进制若缓存旧状态，构建会卡在 Building image…。
Dockerfile 或 buildpacks 缺一不可，否则部署静默失败
Cloud Code 走 Skaffold 构建流程，但它不会自动补容器化逻辑。现象是：点击部署后长时间卡住，日志里只有 Building image...，最后超时。
- Node.js/Python 项目可不写
Dockerfile，但必须有cloudbuild.yaml或声明 buildpacks（插件新建项目时默认带） - C++/Go 项目必须提供
Dockerfile，且入口需监听0.0.0.0:8080 - 检查
skaffold.yaml中build.artifacts.image和deploy.run.image是否一致，否则推送到镜像仓库但部署找不到镜像
本地调试失败还常因端口冲突——Cloud Run Emulator 默认占 8080，若被 Chrome 或其他服务占用，模拟器启动失败却无提示，得看 Skaffold 日志才能发现。
