认证环境变量与加载

持久保存非敏感配置，理解首个 .env 文件、继承与项目选择。

This page has not been translated into English yet. The original Chinese version is shown below.

在当前 shell 导出的变量通常只影响它和后续子进程。希望新的终端沿用配置时，可写入 shell 启动文件或 Gemini 的 .env，同时检查当前使用的是哪一个账号与后端。

Shell 配置

Bash/Zsh 常见启动文件为 ~/.bashrc、~/.zshrc、~/.profile，PowerShell 使用 $PROFILE。选择实际 shell 会加载的文件，不能假设任意文件都立即生效。

项目 ID 用 GOOGLE_CLOUD_PROJECT，也接受回退变量 GOOGLE_CLOUD_PROJECT_ID；同时存在时前者优先。Vertex AI 另需 GOOGLE_CLOUD_LOCATION。

官方认证指南建议在项目或用户目录使用 .gemini/.env。CLI 使用找到的第一个文件，不将所有文件合并。认证指南、配置正文和当前源码对搜索细节有差异，完整顺序与版本限制见环境文件加载。

例如用户范围文件可保存：

GOOGLE_CLOUD_PROJECT="your-project-id"

一个更近的项目文件可能使你以为用户文件“没有生效”。排障时先定位被选中的文件，再检查当前 shell 是否仍导出了旧值；完整配置优先级以配置为准。

GEMINI_API_KEY 用于 AI Studio，GOOGLE_API_KEY 可用于 Vertex AI；切换到 ADC 或服务账号 JSON 时按认证指南取消这两个变量。GOOGLE_APPLICATION_CREDENTIALS 指向服务账号 JSON 绝对路径。

从同一 shell 启动的程序可读取其导出的 key 或凭据路径。CI 中由受控秘密存储注入，手册中仅保留占位符；不要用把秘密提交进 .env 的方式让团队共享认证。