Otterlang项目部署指南：从开发环境到生产系统

【免费下载链接】otterlangOtterlang programming language 🦦项目地址: https://gitcode.com/gh_mirrors/ot/otterlang

Otterlang是一种现代化的编程语言，本指南将帮助你从开发环境搭建到生产系统部署，全面掌握Otterlang项目的部署流程。无论是新手还是有经验的开发者，都能通过本指南快速上手Otterlang的部署工作。

准备工作：获取Otterlang源代码

在开始部署Otterlang之前，首先需要获取项目的源代码。打开终端，执行以下命令克隆Otterlang仓库：

git clone https://gitcode.com/gh_mirrors/ot/otterlang cd otterlang

开发环境搭建：两种高效方法

推荐方法：使用Nix实现一键部署

Nix是一种功能强大的包管理器，能够提供可重现的开发环境，是部署Otterlang的推荐方式。

安装Nix

macOS和Linux系统：

# 运行Nix安装程序 sh <(curl -L https://nixos.org/nix/install) --daemon

安装完成后，重启终端或运行以下命令使Nix生效：

. ~/.nix-profile/etc/profile.d/nix.sh

验证Nix安装：

nix --version

如果安装成功，将显示Nix的版本号。

使用Nix部署Otterlang开发环境

# 进入开发环境 nix develop # 构建编译器（Nix默认设置为nightly工具链） cargo build --release

Nix flake会自动提供以下依赖：

• Rust nightly工具链
• 带有WebAssembly支持的LLVM 18
• 所有必需的系统依赖

这种方法确保了不同系统上构建的一致性，非常适合团队协作和开源项目开发。

手动安装：适合高级用户

如果你更喜欢手动控制依赖安装过程，可以按照以下步骤进行。

系统要求

• Rust nightly：Otterlang的FFI功能需要Rust nightly版本
• LLVM 18：用于代码生成和WebAssembly支持

macOS系统

# 安装LLVM 18 brew install llvm@18 # 设置环境变量 export LLVM_SYS_181_PREFIX=$(brew --prefix llvm@18) export LLVM_SYS_180_PREFIX=$LLVM_SYS_181_PREFIX export PATH="$LLVM_SYS_181_PREFIX/bin:$PATH" # 安装Rust nightly rustup toolchain install nightly # 构建OtterLang cargo +nightly build --release

Ubuntu/Debian系统

# 安装LLVM 18 sudo apt-get update sudo apt-get install -y llvm-18 llvm-18-dev clang-18 # 设置环境变量 export LLVM_SYS_181_PREFIX=/usr/lib/llvm-18 export LLVM_SYS_180_PREFIX=$LLVM_SYS_181_PREFIX # 安装Rust nightly rustup toolchain install nightly # 构建OtterLang cargo +nightly build --release

Fedora/RHEL系统

# 安装LLVM 18 sudo dnf -y install llvm18 llvm18-devel clang18 # 设置环境变量 export LLVM_SYS_181_PREFIX=/usr/lib64/llvm18 export LLVM_SYS_180_PREFIX=$LLVM_SYS_181_PREFIX # 安装Rust nightly rustup toolchain install nightly # 构建OtterLang cargo +nightly build --release

Windows系统

Windows用户可以使用提供的Powershell脚本setup.ps1来准备环境：

# 安装Rust nightly rustup toolchain install nightly # 运行设置脚本 ./setup.ps1 # 构建OtterLang cargo +nightly build --release

setup.ps1脚本会自动完成以下工作：

1. 初始化Visual Studio开发环境
2. 下载LLVM 18
3. 安装Ninja构建工具
4. 下载libxml2
5. 配置环境变量

部署验证：运行和测试Otterlang程序

构建完成后，otter二进制文件将位于target/release/otter。

运行示例程序

# 直接运行程序 ./target/release/otter run examples/basic/hello.ot # 或者使用cargo cargo +nightly run --release --bin otter -- run examples/basic/hello.ot

构建可执行文件

# 构建独立可执行文件 ./target/release/otter build examples/basic/hello.ot -o hello

运行测试套件

# 运行测试套件 cargo +nightly test --release # 运行特定测试 cargo +nightly test --release test_name

生产环境部署：从构建到优化

安装Otterlang到系统

构建成功后，可以将Otterlang安装到系统中，方便全局使用：

cargo install --path . --bin otter --force

Otterlang二进制文件将安装在：

~/.cargo/bin/otter

确保~/.cargo/bin在你的PATH中。如果使用zsh/bash，可以将以下内容添加到~/.zshrc或~/.bashrc：

export PATH="$HOME/.cargo/bin:$PATH"

核心部署命令

Otterlang提供了丰富的命令行工具，以下是部署过程中常用的核心命令：

运行程序

otter run program.ot [options]

选项：

• --debug- 启用调试模式，显示额外日志
• --quiet- 抑制非错误输出
• --lib-path <PATH>- 添加库搜索路径

构建可执行文件

otter build program.ot [options]

选项：

• -o, --output <FILE>- 输出文件路径
• --target <TARGET>- 编译目标（native、wasm32-unknown-unknown、wasm32-wasi）
• --release- 启用发布优化

示例：

otter build hello.ot otter build program.ot -o myapp otter build app.ot --target wasm32-unknown-unknown -o app.wasm

代码格式化

otter fmt [files...] [options]

选项：

• --check- 检查文件是否格式化正确（不修改文件）

WebAssembly部署

Otterlang可以将程序编译为WebAssembly (WASM)，用于在Web浏览器或其他WASM运行时环境中运行。

基础WebAssembly（无WASI）

otter build program.ot --target wasm32-unknown-unknown -o program.wasm

带WASI支持的WebAssembly

otter build program.ot --target wasm32-wasi -o program.wasm

目标差异

• wasm32-wasi- WebAssembly系统接口

  • 最适合：服务器端WASM、命令行工具、WASI兼容运行时
  • 完整WASI支持：直接访问stdio、文件系统、网络和其他系统API
  • 运行时兼容性：可在任何WASI兼容运行时（wasmtime、WasmEdge等）中工作

• wasm32-unknown-unknown- 基础WebAssembly

  • 最适合：Web浏览器、嵌入式系统、自定义宿主环境
  • 最小导入：只需要几个宿主函数用于I/O
  • 更小的二进制文件：没有WASI运行时开销
  • 浏览器兼容：可以直接在Web浏览器中运行（需要适当的宿主环境）

运行WASM示例

# 使用wasmtime运行WASI程序 wasmtime fibonacci.wasm

性能优化与调优

为了在生产环境中获得最佳性能，可以使用以下优化选项：

构建优化

# 构建优化的发布版本 otter build examples/hello.ot --release

内存分析

# 分析内存使用情况 otter profile memory examples/hello.ot

垃圾回收调优

Otterlang提供了多种垃圾回收策略，可以根据应用需求进行调整：

# 选择垃圾回收策略 otter run program.ot --gc-strategy generational # 设置堆使用阈值 otter run program.ot --gc-threshold 0.8 # 设置周期性GC周期 otter run program.ot --gc-interval-ms 100

更多关于垃圾回收的详细信息，请参考docs/GC_GUIDE.md。

部署更新与维护

更新Otterlang

要更新已安装的Otterlang二进制文件：

cargo install --path . --bin otter --force

环境变量配置

Otterlang可以通过环境变量进行配置，常用的环境变量包括：

• OTTER_LOG- 设置日志级别
• OTTER_FFI_CACHE- FFI桥缓存目录
• OTTER_LIB_PATH- 额外的库搜索路径
• OTTER_GC_STRATEGY- 垃圾回收策略
• OTTER_GC_THRESHOLD- 垃圾回收阈值
• OTTER_GC_INTERVAL- 垃圾回收间隔
• OTTER_GC_DISABLED_MAX_BYTES- 禁用GC时的最大分配字节数

故障排除

Nix构建出现libffi错误： 如果在Nix环境外运行时遇到"libffi.so.8"错误，请使用Nix环境：

nix develop ./target/release/otter run program.ot

LLVM未找到： 验证LLVM_SYS_181_PREFIX是否指向正确的LLVM安装目录，并且LLVM二进制文件在你的PATH中。

总结

通过本指南，你已经了解了Otterlang从开发环境搭建到生产系统部署的完整流程。无论是使用推荐的Nix方法还是手动安装，都可以成功部署Otterlang项目。Otterlang提供了丰富的命令行工具和优化选项，帮助你在生产环境中获得最佳性能。

如果你需要更多帮助，可以查阅官方文档：

• docs/GETTING_STARTED.md
• docs/GC_GUIDE.md
• docs/FFI_GUIDE.md

【免费下载链接】otterlangOtterlang programming language 🦦项目地址: https://gitcode.com/gh_mirrors/ot/otterlang