使用VSCode Cloud Code扩展，如何在本地模拟器设置环境变量？

问题概述 #

我已掌握Cloud Run控制台设置环境变量的方法，但使用VSCode搭配Cloud Code扩展在本地模拟器中配置时遇到以下问题：

• 首次运行时的高级设置窗口仅弹出一次，后续运行无法找到配置入口
• 官方文档方法会将配置写入launch.json，但该文件需提交至Git，不想暴露环境变量
• 自行添加.env文件后，代码中process.env.MY_VARIABLE始终返回undefined

解决方案 #

1. 重新调出高级设置窗口 #

若首次运行后无法找到配置入口，可通过以下方式重新打开设置界面：

• 打开左侧「运行和调试」面板（快捷键：Ctrl+Shift+D）
• 若未创建launch.json，点击顶部「创建launch.json文件」；若已有配置，点击配置下拉框选择「添加配置」
• 选择「Cloud Run: Run Locally」模板，即可重新打开高级设置窗口，修改完成后保存配置

2. 避免环境变量写入Git跟踪文件 #

方法一：通过.env文件加载（推荐）

Cloud Code不会自动读取.env文件，需在launch.json中显式配置加载路径：
在launch.json的cloudRun配置块中添加：

"envFile": "${workspaceFolder}/.env"

在项目根目录创建.env文件，格式如下：

MY_VARIABLE=your_custom_value
ANOTHER_ENV_VAR=another_value

最后将.env加入.gitignore，防止提交至Git。

方法二：使用VSCode工作区本地配置

打开「文件 > 首选项 > 设置 > 工作区」，搜索「Cloud Code: Environment Variables」，添加所需环境变量键值对。这些配置会保存在.vscode/settings.json中，可将该文件加入.gitignore以仅在本地生效。

3. 确保.env文件生效的注意事项 #

• 确认.env文件放置在项目根目录，与launch.json同级
• 检查launch.json中envFile的路径是否正确，推荐使用${workspaceFolder}/.env确保指向根目录
• 修改.env后需重启本地模拟器，环境变量才会重新加载
• 代码中读取环境变量时需注意变量名大小写与.env文件完全一致

内容的提问来源于stack exchange，提问作者Nelu