Cloud Code 插件依赖本地 gcloud CLI 认证与项目配置，需提前执行 gcloud auth login 和 gcloud config set project YOUR-PROJECT-ID，否则部署按钮置灰或报错；未启用 cloudcode.enableCloudRunSupport 则无法调用 Cloud Run 调试功能。
Cloud Code 插件本身不直接“连接” GCP，它依赖本地 gcloud CLI 的认证状态和项目配置来执行部署；没配好 gcloud，插件所有部署按钮都是灰色或报错。
gcloud auth login 和 gcloud config set project 必须提前完成
Cloud Code 不会替你登录账号或选项目——它只读取当前 gcloud 配置上下文。常见错误包括：
- 点击 “Deploy to Cloud Run” 后弹出
ERROR: (gcloud.beta.run.deploy) You do not currently have an active account selected. - 部署成功但跑在错误项目里（比如默认用了上次的 demo-project）
必须在终端中顺序执行：
gcloud auth login<br>gcloud config set project YOUR-PROJECT-ID<br>gcloud services enable run.googleapis.com
验证是否生效：gcloud projects list 能看到项目，gcloud config list project 输出应为你的目标 ID。VSCode 内置终端需重启才能继承这些环境变量。
Cloud Run 部署前必须有 Dockerfile 或 buildpacks 支持
Cloud Code 默认走 Skaffold 构建流程，但它不会自动帮你写容器化逻辑。如果你的项目没有 Dockerfile，又没声明 buildpacks，部署会卡在 “Building image…” 并超时。
- Node.js/Python 项目可省略
Dockerfile，改用cloudbuild.yaml+ buildpacks（插件创建新应用时默认启用） - C++/Go 等需显式提供
Dockerfile，且必须暴露8080端口、监听0.0.0.0:8080 - 若用自定义构建，确保
skaffold.yaml中的build.artifacts.image与deploy.run.image一致
示例关键片段（skaffold.yaml）：
build:<br> artifacts:<br> - image: gcr.io/YOUR-PROJECT-ID/my-app<br>deploy:<br> run:<br> image: gcr.io/YOUR-PROJECT-ID/my-app
调试时端口冲突和本地模拟器未启动是高频失败点
选择 “Debug on Cloud Run” 后，插件会拉起本地 Cloud Run Emulator，但这个过程容易静默失败：
- 本地
8080端口被占用 → Emulator 启动失败，VSCode 却显示 “Debugging started”，实际无服务响应 -
main.py或index.js入口文件路径不对 → 模拟器报ModuleNotFoundError或Cannot find module，但错误堆栈藏在 Skaffold 日志里 - 未启用
cloudcode.enableCloudRunSupport设置项 → 命令面板搜不到 “Debug on Cloud Run”
排查建议：
- 先手动运行
cloud-run-emulator start（需单独安装），确认能起来 - 在 VSCode 设置中搜索并启用
cloudcode.enableCloudRunSupport - 右键点击函数入口文件（如
main.py），选 “Run on Cloud Run Emulator” 测试基础流程是否通
部署到私有 Artifact Registry 而非 GCR 需手动改 skaffold.yaml
新版 GCP 推荐用 Artifact Registry 替代 GCR，但 Cloud Code 创建项目时仍默认生成 gcr.io 地址。如果项目已启用 Artifact Registry，不改镜像地址会导致推送失败：
- 错误信息类似：
ERROR: failed to push image: failed to authorize request to https://us-west1-docker.pkg.dev/v2/... - 原因：Skaffold 尝试推送到 GCR，但项目权限只开了 Artifact Registry
修复方式：编辑 skaffold.yaml，把所有 gcr.io/YOUR-PROJECT-ID/xxx 替换为 Artifact Registry 地址，例如：
image: us-west1-docker.pkg.dev/YOUR-PROJECT-ID/my-repo/my-app
注意：区域（us-west1）、仓库名（my-repo）要和你在 Console 创建的一致，且服务账号需有 artifactregistry.repositories.uploadArtifacts 权限。
最常被跳过的其实是 gcloud auth login --update-adc 这一步——旧凭据过期后，gcloud auth list 可能仍显示 ACTIVE，但部署时提示权限不足，得重刷 ADC 凭据才真正生效。
