📢 Release 1.0.0-beta.9(2026-03-26)现已推出
Arcadia

环境配置

本篇介绍一些关键的用户配置

用户环境变量

环境变量是控制代码行为的主要途径之一,项目对于配置环境变量的方式有两套设计,可以同时配置

下面具体介绍两种配置方式与基本工作原理

控制面板《环境配置 - 环境变量》

本项目对环境变量功能有着独特的功能设计,变量类型分为 普通变量复合变量
复合变量是普通变量的高级应用,它可以将多个值分开管理最后合并成一个值,实现了更加灵活的配置以满足用户需求

该功能变量数据存储在数据库中,每次修改后都会在用户配置文件目录下自动生成 env.sh 批量声明脚本,以用于 CLI 命令加载

主配置文件

主配置文件为 config.sh,你可以通过控制面板《环境配置 - 配置文件》进行在线编辑

首先你需要知道的是在配置文件中用 export 关键字声明的变量为全局变量,否则为局部变量

示例
export TEST_ENV="Hello World!"

只有全局变量配置的信息才能被所运行的代码文件获取,局部变量一般用于控制内部项目功能

在配置文件中声明全局环境变量是一种更加直接的底层配置方式,因为由数据库存储的另一种配置方式最终也会转换成这种形式

你需要知道的设计细节

Arcadia CLI 先加载数据库生成的环境变量批量加载脚本 env.sh 再加载配置文件 config.sh,这意味着若存在相同变量那么会被 config.sh 中定义的变量覆盖

命令行配置

详见面板《个人设置 - 命令行》