运行环境
本部分文档用于指导代码文件运行环境配置,如果你对相关技术不是很熟悉那么请认真阅读以下内容
安装语言环境
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 tsxts-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 -yNode.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 goapt-get update && apt-get install -y lua5.4 luarocksapt-get update && apt-get install -y rubycurl --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 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>"建议使用 cpanm,安装命令 cpan App::cpanminus
cpanm <xxx>适用文件类型 .pl .pm

