在使用阿里云 DASHSCOPE 智能服务（如大模型调用、AI 生成能力等）时，API_KEY 是关键的身份验证凭证，而环境变量配置则能让本地或服务器项目更安全、便捷地调用服务。这篇文章会用「 step-by-step 」的实操形式，带你完成从 API_KEY 获取到环境变量配置的全流程，新手也能跟着走，建议收藏避免后续反复找教程。

一、前置准备：明确核心前提

在开始操作前，先确认两个基础条件，避免中途卡壳：

1. 拥有阿里云账号，且完成实名认证（个人或企业认证均可，未认证账号无法创建 API_KEY）；
2. 确保账号已开通 DASHSCOPE 服务（默认未开通，开通过程免费，后续按调用量计费，新用户有免费额度）。

二、手把手获取阿里云 DASHSCOPE_API_KEY

这部分是核心步骤，每一步都附具体操作路径，跟着点就能拿到 API_KEY：

1. 登录阿里云控制台并找到 DASHSCOPE 入口

• 打开阿里云官网（www.aliyun.com），点击右上角「登录」，输入账号密码或扫码登录；
• 登录后，在顶部搜索栏输入「DASHSCOPE」，点击搜索结果中的「DASHSCOPE 智能服务平台」，进入服务主页。

2. 开通 DASHSCOPE 服务（未开通用户必做）

• 若首次进入，会看到「开通服务」按钮，点击后跳转至服务协议页面；
• 仔细阅读协议（主要是计费规则和使用规范），勾选「我已阅读并同意」，点击「立即开通」，10 秒内即可完成开通（无需额外付费，开通后默认进入「免费额度」模式）。

3. 创建并获取 DASHSCOPE_API_KEY

• 开通后回到 DASHSCOPE 主页，点击左侧菜单栏的「API 密钥管理」；
• 进入密钥管理页面后，点击右上角「创建 API 密钥」，系统会弹出确认窗口；
• 无需修改默认设置（密钥名称可自定义，方便区分用途，如「个人项目密钥」），点击「确定」，系统会生成一对「API 密钥」（包含「Access Key ID」和「Access Key Secret」，这两个组合就是后续要用的 DASHSCOPE_API_KEY，注意：Secret 只会显示一次，务必立即保存）；
• 保存方式建议：用记事本或密码管理工具记录（不要截图存手机，避免泄露），若不慎关闭页面未保存 Secret，只能删除旧密钥重新创建（旧密钥删除后立即失效，已用旧密钥的项目会报错）。

三、环境变量配置：分系统实操（Windows/macOS/Linux）

获取 API_KEY 后，配置环境变量能避免在代码中硬写密钥（防止泄露风险），不同操作系统配置方式不同，以下是详细步骤：

1. Windows 系统配置（两种方式，新手推荐图形化）

方式 1：图形化界面配置（适合新手，无需命令行）

• 右键点击「此电脑」→「属性」→「高级系统设置」→「环境变量」；
• 在「系统变量」栏（建议配置系统变量，所有用户和项目都能使用）点击「新建」；
• 变量名填写：DASHSCOPE_ACCESS_KEY_ID，变量值填写第一步获取的「Access Key ID」，点击「确定」；
• 再次点击「新建」，变量名填写：DASHSCOPE_ACCESS_KEY_SECRET，变量值填写第一步获取的「Access Key Secret」，点击「确定」；
• 配置完成后，关闭所有已打开的命令行 / IDE（如 VS Code、PyCharm），重新打开即可生效（生效验证：打开 cmd，输入 echo %DASHSCOPE_ACCESS_KEY_ID%，若显示之前填写的 ID，说明配置成功）。

方式 2：命令行配置（适合熟悉命令行的用户）

• 按下 Win + R，输入 cmd 打开命令行；
• 输入以下两条命令（替换括号内的内容为你的密钥），按回车执行：

  cmd

  setx DASHSCOPE_ACCESS_KEY_ID "你的Access Key ID" /m
  setx DASHSCOPE_ACCESS_KEY_SECRET "你的Access Key Secret" /m
  

• 执行完成后，关闭命令行，重新打开验证（同图形化方式的验证命令）。

2. macOS 或 Linux 系统配置（终端命令行）

步骤 1：打开终端并编辑环境变量文件

• 打开终端（macOS 用 Spotlight 搜索「终端」，Linux 直接按 Ctrl + Alt + T）；
• 若使用默认的 bash 终端，输入命令：nano ~/.bash_profile；若使用 zsh 终端（macOS 10.15+ 默认），输入：nano ~/.zshrc（不确定终端类型？输入 echo $SHELL，显示 /bin/bash 则用 bash 文件，显示 /bin/zsh 则用 zshrc 文件）。

步骤 2：添加环境变量内容

• 在打开的文件中，按下「Enter」换行，添加以下两行（替换括号内的内容）：

  bash

  export DASHSCOPE_ACCESS_KEY_ID="你的Access Key ID"
  export DASHSCOPE_ACCESS_KEY_SECRET="你的Access Key Secret"
  

• 添加完成后，按下 Ctrl + O 保存，按「Enter」确认文件名，再按 Ctrl + X 退出编辑。

步骤 3：让配置生效并验证

• 输入命令让配置立即生效：bash 终端用 source ~/.bash_profile，zsh 终端用 source ~/.zshrc；
• 验证是否生效：输入 echo $DASHSCOPE_ACCESS_KEY_ID，若显示密钥 ID，说明配置成功。

四、避坑指南：3 个常见问题解决

1. API_KEY 创建后不显示 Secret？这是阿里云的安全机制，Secret 仅在创建时显示一次，若未保存，只能在「API 密钥管理」页面删除旧密钥，重新创建新的（删除前确保旧密钥未在项目中使用）。

2. 配置环境变量后，项目调用仍报错「密钥不存在」？大概率是配置后未重启命令行 / IDE，环境变量需要重启应用才能读取；若重启后仍报错，检查变量名是否写错（必须和上述一致，区分大小写，如 DASHSCOPE_ACCESS_KEY_ID 不能少下划线）。

3. API_KEY 突然失效？可能是密钥被误删除、账号实名认证过期，或超出免费额度且未充值；先去「API 密钥管理」确认密钥状态，再检查 DASHSCOPE 控制台的「费用中心」，确认是否有欠费。

五、后续使用：快速调用验证

配置完成后，可通过简单代码验证是否能正常调用 DASHSCOPE 服务（以 Python 为例，需先安装 dashscope 库：pip install dashscope）：

python

import dashscope

# 无需硬写密钥，会自动读取环境变量
dashscope.api_key = {
    "access_key_id": dashscope.getenv("DASHSCOPE_ACCESS_KEY_ID"),
    "access_key_secret": dashscope.getenv("DASHSCOPE_ACCESS_KEY_SECRET")
}

# 调用一个简单的文本生成接口，测试是否生效
response = dashscope.Generation.call(
    model="qwen-turbo",
    prompt="Hello, DASHSCOPE!"
)
print(response)