您调用LAS 算子之前，您需要先生成 API Key 用于算子调用的鉴权。同时因为 API Key 信息较为敏感，泄露 API Key 会导致您的模型用量被其他人花费，造成一定的损失，因此获取 API Key 后建议将 API Key 配置为环境变量的，方便您合理安全地使用API Key。

登录LAS 控制台后，在 资源管理 > API Key 管理页面，点击左上角的创建 API Key。根据界面提示创建 API Key。

如果您使用了 LAS 开发机环境来调用算子进行数据处理任务开发，推荐将 API Key 配置在环境变量中，而不是硬编码进代码中，避免 API Key 随代码泄露，导致配额被他人使用，产生额外花费。

基础概念 #

环境变量是操作系统级的键值对，用于存储配置信息，能够影响运行中进程的行为。它们分为两类：

• 临时变量: 仅在创建它的终端会话中有效。关闭终端后即失效。
• 永久变量: 持久化存储在系统配置文件中，在新的终端会话或系统重启后依然有效。

主流操作系统的配置概要示例如下。

详细的配置指导可参见下文。

macOS & Linux 配置说明 #

在类 Unix 系统中，环境变量的配置与您使用的 Shell 密切相关。

了解 Shell 配置文件 #

• ~/.bash_profile: Bash 登录 Shell 时加载。通常用于定义希望在整个用户会话期间都可用的变量。
• ~/.bashrc: Bash 交互式非登录 Shell 时加载。适合定义别名和函数。
• ~/.zshenv: (推荐用于环境变量) Zsh 每次启动时都会加载，无论是否是登录或交互式 Shell。这是设置环境变量最可靠的地方。
• ~/.zprofile: Zsh 登录 Shell 时加载，在 .zshenv 之后。
• ~/.zshrc: Zsh 交互式 Shell 时加载。适合配置 Shell 交互相关的设置（如提示符、别名）。

Bash / Zsh 配置 #

临时配置

在终端中执行 export 命令。

# 示例：临时设置 LAS_API_KEY
export LAS_API_KEY="your-las-api-key-here"

永久配置

1. 打开在终端，使用以下命令，查看默认 Shell 类型。

   echo $SHELL
   
   # 返回/bin/zsh：默认的 Shell 类型是 Zsh（ Z shell）。
   
   # 返回/bin/bash：默认的 Shell 类型是 Bash。 
   

2. 打开您的 Shell 配置文件。对于 Zsh 用户，推荐 ~/.zshenv。

   # Zsh 用户
   nano ~/.zshenv
   
   # Bash 用户
   nano ~/.bash_profile
   

3. 在文件末尾添加 export 语句。

   # 设置 LAS_API_KEY 环境变量
   export LAS_API_KEY="your-las-api-key-here"
   

4. 保存文件，然后运行 source 命令或重启终端使配置生效。

   # Zsh 用户
   source ~/.zshrc
   
   # Bash 用户
   source ~/.bash_profile
   

PowerShell (macOS / Linux) #

PowerShell 在所有平台上的行为基本一致。

临时配置

$env:LAS_API_KEY = "your-las-api-key-here"

永久配置

1. 编辑 PowerShell 的配置文件。

   # 这会自动用默认编辑器打开配置文件
   code $profile
   

2. 在文件中添加以下行：

   $env:LAS_API_KEY = "your-las-api-key-here"
   

3. 保存文件，然后运行 . 命令或重启 PowerShell。

   . $profile
   

Windows 配置说明 #

Windows 将环境变量分为“用户变量”和“系统变量”。前者仅对当前用户有效，后者对所有用户有效。

Command Prompt (CMD) #

临时配置

使用 set 命令。

set LAS_API_KEY=your-las-api-key-here

永久配置

使用 setx 命令。

:: 设置用户变量
setx LAS_API_KEY "your-las-api-key-here"

:: 设置系统变量 (需要管理员权限)
setx LAS_API_KEY "your-las-api-key-here" /m

注意: setx 设置的变量在新的命令提示符窗口中才会生效，不会影响当前窗口。

PowerShell #

临时配置

$env:LAS_API_KEY = "your-las-api-key-here"

永久配置

使用 .NET API 是最可靠的方式。

# 设置用户变量
[Environment]::SetEnvironmentVariable("LAS_API_KEY", "your-las-api-key-here", "User")

# 设置系统变量 (需要管理员权限)
[Environment]::SetEnvironmentVariable("LAS_API_KEY", "your-las-api-key-here", "Machine")

图形用户界面 (GUI) #

1. 在开始菜单搜索“编辑系统环境变量”并打开。
2. 在“系统属性”对话框中，点击“环境变量...”按钮。
3. 在弹出的窗口中，您可以在上半部分为您的用户账户添加/修改“用户变量”，或在下半部分为所有用户添加/修改“系统变量”。
4. 点击“新建...”并输入变量名 LAS_API_KEY 和您的密钥作为变量值。
5. 逐层点击“确定”关闭所有对话框。

验证配置 #

配置完成后，您可以通过以下方式验证：

• macOS / Linux:

  echo $LAS_API_KEY
  

• Windows (CMD):

  echo %LAS_API_KEY%
  

• PowerShell (所有平台):

  echo $env:LAS_API_KEY
  # 或者
  Get-ChildItem env:LAS_API_KEY
  

对于永久配置，请务必重启您的终端或 IDE后再次检查，以确保配置已正确加载。

高级技巧与实践 #

安全性：保护您的密钥 #

警告: 绝对不要将包含 LAS_API_KEY 等敏感信息的配置文件提交到 Git 等版本控制系统。

• 使用 .gitignore: 确保包含敏感信息的本地配置文件（如 .envrc, .env）被添加到 .gitignore 文件中。
• 项目级环境变量: 对于特定项目，推荐使用 .env 文件来管理环境变量，并结合 dotenv (Node.js), python-dotenv (Python) 等库在应用启动时加载它们。

目录级环境变量 direnv #

direnv 是一个强大的工具，它可以在您进入或离开项目目录时自动加载或卸载环境变量。

1. 安装 (以 macOS Homebrew 为例):

   brew install direnv
   

2. 配置: 在项目根目录创建一个 .envrc 文件。

   # .envrc
   export LAS_API_KEY="your-project-specific-key"
   

3. 授权: 首次进入目录时，运行 direnv allow。之后每次进入该目录，.envrc 中的变量都会自动生效。