如何在不同系统中设置 DASHSCOPE_API_KEY 环境变量？

Question

**问题：如何在不同操作系统中正确设置 DASHSCOPE_API_KEY 环境变量？** 在使用 DashScope API 时，设置 `DASHSCOPE_API_KEY` 环境变量是一种常见且安全的做法。然而，不同操作系统（如 Windows、Linux、macOS）设置环境变量的方式略有不同，容易造成混淆。例如，在 Linux/macOS 中可通过 `export` 命令临时设置，或写入 `.bashrc`、`.zshrc` 文件实现持久化；而 Windows 用户则需通过系统属性或使用 `setx` 命令进行配置。此外，开发者还需注意环境变量的作用域和生命周期问题，确保其在开发、测试和部署环境中均能被正确读取。如何在不同系统中正确设置并验证 `DASHSCOPE_API_KEY`，是保障应用顺利调用 API 的关键步骤。

Answer 1

一、环境变量的基本概念与作用

环境变量是操作系统提供的一种机制，用于在不同程序或脚本之间传递配置信息。对于使用 DashScope API 的开发者来说，设置 DASHSCOPE_API_KEY 是一个基础但关键的步骤。通过环境变量设置 API 密钥，可以避免将敏感信息硬编码在代码中，提升安全性和可维护性。

环境变量具有作用域和生命周期的特性，分为临时变量和持久变量。临时变量仅在当前会话中有效，重启终端或系统后会失效；而持久变量则需要写入配置文件或系统设置中，确保每次启动时自动加载。

二、在 Linux 系统中设置 DASHSCOPE_API_KEY

Linux 系统支持多种 Shell，如 Bash、Zsh 等，环境变量的设置方式略有不同。以下是以 Bash 为例的设置方法：

1. 临时设置（当前终端会话）

export DASHSCOPE_API_KEY='your_api_key'

该命令仅在当前终端会话中生效，关闭终端后失效。

2. 持久设置（写入配置文件）

将以下内容添加到 ~/.bashrc 或 ~/.bash_profile 文件中：

export DASHSCOPE_API_KEY='your_api_key'

保存后执行以下命令使配置生效：

source ~/.bashrc

三、在 macOS 系统中设置 DASHSCOPE_API_KEY

macOS 基于 Unix，其 Shell 环境变量设置方式与 Linux 类似，但默认 Shell 可能为 Zsh（从 macOS Catalina 开始）。

1. 临时设置

export DASHSCOPE_API_KEY='your_api_key'

2. 持久设置

将变量写入 ~/.zshrc 或 ~/.bash_profile（根据当前 Shell 类型）：

echo 'export DASHSCOPE_API_KEY="your_api_key"' >> ~/.zshrc

执行以下命令应用更改：

source ~/.zshrc

四、在 Windows 系统中设置 DASHSCOPE_API_KEY

Windows 系统的环境变量设置方式与类 Unix 系统不同，主要通过系统属性界面或命令行工具进行。

1. 临时设置（当前命令行窗口）

set DASHSCOPE_API_KEY=your_api_key

该变量仅在当前 CMD 或 PowerShell 窗口中有效。

2. 持久设置（通过命令行）

使用 setx 命令设置持久变量：

setx DASHSCOPE_API_KEY "your_api_key"

该命令将环境变量写入注册表，下次启动命令行时生效。

3. 通过系统属性设置

1. 右键点击“此电脑”或“我的电脑”，选择“属性”。
2. 点击“高级系统设置” > “环境变量”。
3. 在“用户变量”或“系统变量”部分点击“新建”。
4. 输入变量名 DASHSCOPE_API_KEY 和对应的 API 密钥。

五、验证环境变量是否设置成功

无论在哪个操作系统中，设置完成后应验证环境变量是否生效。

操作系统	验证命令
Linux / macOS	echo $DASHSCOPE_API_KEY
Windows (CMD)	echo %DASHSCOPE_API_KEY%
Windows (PowerShell)	echo $env:DASHSCOPE_API_KEY

六、环境变量作用域与生命周期分析

理解环境变量的作用域和生命周期是正确配置的关键：

• 作用域：环境变量可以分为用户级和系统级。用户级变量只对当前用户生效，系统级变量对所有用户生效。
• 生命周期：临时变量随当前会话结束而失效；持久变量则需写入配置文件或系统注册表。

在开发、测试和部署环境中，应确保环境变量在相应作用域内正确配置，避免因权限或路径问题导致密钥读取失败。

七、开发与部署环境中的最佳实践

为了保障 API 密钥的安全性和可维护性，建议采用如下最佳实践：

• 在开发阶段使用临时变量快速测试，避免误提交密钥。
• 在部署阶段使用持久变量，并通过 CI/CD 工具注入密钥，如 GitHub Actions Secrets、GitLab CI Variables 等。
• 避免在代码中硬编码密钥，推荐使用 os.getenv()（Python）、process.env（Node.js）等方式读取。