VSCode for Google Cloud Platform开发指南

vscode是GCP开发首选编辑器，通过google Cloud Code、Terraform等扩展实现Cloud Functions/Run本地调试、Secret Manager密钥管理及GKE/Cloud Run深度调试。

VSCode 是 Google Cloud Platform（GCP）开发中轻量、高效且高度可定制的首选编辑器。它不自带 GCP 原生支持，但通过合理配置扩展与工具链，能完整覆盖 Cloud Functions、Cloud Run、GKE 本地调试、terraform 管理、Secrets 处理及 CLI 集成等核心场景。

必备扩展：让 VSCode 真正“懂”GCP

安装以下扩展是基础前提，缺一不可：

• Google Cloud Code：官方扩展，提供 Cloud Run/Functions 一键部署、本地模拟器集成、kubernetes 清单智能补全和 Skaffold 支持；
• Cloud Code for VS Code（旧版兼容）：若使用较老项目结构，可保留；
• Terraform（HashiCorp 官方）：语法高亮、资源块自动补全、terraform validate 和 fmt 集成；
• Google Cloud SDK：确保已安装 gcloud CLI 并加入系统 PATH，VSCode 终端才能识别 gcloud auth login 或 gcloud config set project；
• REST Client：快速测试 Cloud Run 或 IAP-protected API 的 http 请求（支持 @auth Token 注入）。

本地开发闭环：从写代码到部署上线

以 Cloud Functions（node.js）为例，无需离开 VSCode 即可完成全流程：

• 用命令面板（Ctrl+Shift+P / Cmd+Shift+P）运行 Cloud Code: Run on Cloud Functions Emulator，启动本地函数模拟器；
• 修改代码后保存，自动热重载（需函数入口为 index.js + functions/index.js 结构）；
• 右键点击函数导出名（如 exports.helloWorld），选择 Deploy to Cloud Functions，自动触发 gcloud functions deploy 并附带当前环境变量与触发器配置；
• 部署成功后，VSCode 底部状态栏显示函数 URL，点击即可在浏览器打开或用 REST Client 发起请求。

安全与配置管理：避免硬编码密钥

GCP 推荐用 Secret Manager 管理敏感数据，VSCode 可无缝衔接：

• 在 .env.local 中仅存放 SECRET_NAME=projects/123456/secrets/my-api-key/versions/latest，而非真实密钥；
• 启用 Google Cloud Secret Manager 扩展（或手动运行 gcloud secrets versions access latest --secret="my-api-key"）；
• 配合 DotENV 扩展，在调试配置 launch.json 中添加：
  "env": {"API_KEY": "${command:extension.env.getSecretValue}"}；
• 确保服务账号有 secretmanager.versions.access 权限，本地调试时用 gcloud auth application-default login 激活凭据。

多环境协同：GKE 与 Cloud Run 调试技巧

对容器化服务，VSCode 提供深度 Kubernetes 支持：

• 安装 Kubernetes Tools 后，打开 kubectl config current-context 对应的集群，左侧活动栏出现 Kubernetes 面板，实时查看 Pod、Service、ConfigMap；
• 右键 Pod → Exec into Container，直接进入容器终端排查日志或网络；
• 对 Cloud Run 服务，使用 Cloud Code: Attach Debugger to Cloud Run Service，自动注入调试探针并映射源码（需镜像含 node --inspect=0.0.0.0:9229 启动参数）；
• 调试时断点命中后，变量视图可展开 process.env 查看所有 GCP 注入环境变量（如 K_REVISION, K_CONFIGURATION）。