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

运行环境

本部分文档用于指导代码文件运行环境配置,如果你对相关技术不是很熟悉那么请认真阅读以下内容

安装语言环境

Bun 是一个现代的 JavaScript 和 TypeScript 运行时环境,内置包管理器,专为速度而设计,运行速度极快,并致力于兼容 Node.js API,许多 Node.js 项目可直接运行。

安装命令(建议分步执行以下命令)
apt-get update && apt-get install -y unzip
curl -fsSL https://bun.sh/install | bash # 失败时请自行解决网络环境等问题
bash
ln -sf $(which bun) /usr/local/bin/bun

建议使用官方提供的默认安装方法,如果你通过其它方法安装那么需要在处理 PATH 时设置 /usr/local/bin 的软链接(参考最后一行示例命令)

官方网站

Deno 是一个现代的 JavaScript 和 TypeScript 运行时环境,具有安全性高、高性能网络等特点。默认采用沙盒机制,脚本程序需显式授予权限才能访问文件系统、网络和环境变量等敏感操作。

Deno 一般无法直接运行 Node.js 原生项目,因为它导入包(库)的语法与 Node.js 不兼容。
由于沙箱下的默认权限不能满足项目基本需求,因此使用 Deno 时会默认赋予一些权限,具体如下:
· 环境变量:允许全部
· 文件系统:仅允许读/写代码文件所在目录和其下级目录。
· 网络访问:允许联网,但禁止访问本机

安装命令(建议分步执行以下命令)
apt-get update && apt-get install -y unzip
curl -fsSL https://deno.land/install.sh | sh # 失败时请自行解决网络环境等问题
bash
ln -sf $(which deno) /usr/local/bin/deno

建议使用官方提供的默认安装方法,如果你通过其它方法安装那么需要在处理 PATH 时设置 /usr/local/bin 的软链接(参考最后一行示例命令)

官方网站

TypeScript Execute (tsx) 是 CLI 运行 TypeScript 代码文件的默认执行器,它基于 esbuild 驱动,运行速度非常快。

安装命令
npm install -g tsx

官方网站

ts-node 是一个运行 TypeScript 代码文件的执行器,诞生较早且已长期未更新,相比 tsx 它的兼容性会更高,不过性能会差很多。

安装命令
npm install -g typescript ts-node

官方网站

已预装,底层功能依赖请勿卸载,否则会导致项目无法正常运行

安装命令
NODE_VERSION=24 # 指定安装版本(可自行修改)
apt-get update && apt-get install -y ca-certificates curl gnupg
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_${NODE_VERSION}.x nodistro main" | tee /etc/apt/sources.list.d/nodesource.list
apt-get update && apt-get install nodejs -y

Node.js 是 Arcadia 平台默认的 JavaScript 运行时环境,同时也是驱动 Arcadia 后端运行的核心依赖,默认安装的是最新的 LTS 版本,需要安装指定版本时可借鉴该命令

官方网站

已预装,TG Bot 功能依赖 Python 环境运行

安装命令
apt-get update && apt-get install -y python3 python3-pip

若你重装了其它版本,那么还需要执行 pip3 install yq --no-cache-dir --break-system-packages 安装 yq 依赖库(CLI 底层功能需要)

官方网站

安装命令
apt-get update && apt-get install -y go

官方网站

安装命令
apt-get update && apt-get install -y lua5.4 luarocks

官方网站

安装命令
apt-get update && apt-get install -y ruby

官方网站

安装命令(建议分步执行以下命令)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh # 失败时请自行解决网络环境等问题
bash
ln -sf $(which rustc) /usr/local/bin/rustc
ln -sf $(which cargo) /usr/local/bin/cargo
cargo install cargo-script # 失败时请自行解决网络环境等问题

建议使用官方提供的默认安装方法,如果你通过其它方法安装那么需要在处理 PATH 时设置 /usr/local/bin 的软链接

官方网站

已预装,底层功能依赖请勿卸载,否则会导致项目无法正常运行

安装命令
apt-get update && apt-get install -y perl

官方网站

已预装,底层功能依赖请勿卸载,否则会导致项目无法正常运行

安装命令
apt-get update && apt-get install -y gcc

解决依赖

安装命令
npm install -g <xxx>

适用文件类型 .js .mjs .cjs .ts .cts .mts

当运行报错提示 Cannot find module 'xxx' 或类似字样时,说明缺少代码运行所需的依赖。
xxx 即为缺失的依赖名称,若以 / 开头表示本地模块文件路径,否则一般为 NPM 上的第三方包。

-g 选项代表全局安装,适用于大多数场景,不使用该选项则会安装在当前项目的 node_modules 目录下。

安装命令
pip3 install <xxx> --break-system-packages

适用文件类型 .py

安装命令
go get -u <xxx>

适用文件类型 .go

安装命令
luarocks install <xxx>

适用文件类型 .lua

安装命令
gem install <xxx>

适用文件类型 .rb

适用文件类型 .rs

Cargo.toml 文件中添加依赖:

[dependencies]
<xxx> = "<version>"

运行以下命令安装依赖:

cargo build

或者仅安装依赖而不构建项目:

cargo check

建议使用 cpanm,安装命令 cpan App::cpanminus

安装命令
cpanm <xxx>

适用文件类型 .pl .pm