安装指南

本指南将帮助你在不同操作系统上安装 Fleet 编程语言。

📋 系统要求

最低要求

  • 操作系统: Windows 10+, macOS 10.15+, Linux (Ubuntu 18.04+, CentOS 7+)
  • 内存: 4GB RAM
  • 存储: 2GB 可用空间
  • 网络: 互联网连接（用于下载依赖）

推荐配置

  • 操作系统: 最新版本
  • 内存: 8GB+ RAM
  • 存储: 10GB+ 可用空间
  • 处理器: 多核 CPU

🔧 依赖项

Fleet 编译器需要以下依赖：

必需依赖

  • Rust: 1.70.0 或更高版本
  • LLVM: 17.0 或更高版本
  • Git: 用于克隆仓库

可选依赖

  • Python 3: 用于文档生成和工具脚本
  • Make: 用于构建自动化

🚀 安装方法

方法一：从源码构建（推荐）

  1. 安装 Rust bash curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh source ~/.cargo/env

  2. 安装 LLVM

macOS (Homebrew): bash brew install llvm@17

Ubuntu/Debian: bash sudo apt update sudo apt install llvm-17-dev libllvm17 llvm-17-runtime

CentOS/RHEL: bash sudo yum install llvm-devel

  1. 克隆仓库 bash git clone https://github.com/tint/fleet.git cd fleet

  2. 构建编译器 bash cargo build --release

  3. 验证安装 bash ./target/release/fleet --version

方法二：预编译二进制文件

  1. 下载二进制文件

访问 Releases 页面 下载适合你系统的预编译版本。

  1. 解压并安装 bash tar -xzf fleet-v1.0.0-linux-x86_64.tar.gz sudo mv fleet /usr/local/bin/

  2. 验证安装 bash fleet --version

🔧 配置环境

环境变量

将以下内容添加到你的 shell 配置文件（~/.bashrc, ~/.zshrc 等）：

# Fleet 编译器路径
export PATH="$PATH:/path/to/fleet/target/release"

# LLVM 路径（如果需要）
export LLVM_SYS_170_PREFIX="/usr/local/opt/llvm@17"

IDE 支持

Visual Studio Code

  1. 安装 Fleet 语言扩展（即将推出）
  2. 配置语法高亮和代码补全

Vim/Neovim

" 添加到 ~/.vimrc
autocmd BufNewFile,BufRead *.fleet set filetype=rust

✅ 验证安装

创建一个简单的 Fleet 程序来验证安装：

  1. 创建测试文件 bash echo 'fn main() { print("Hello, Fleet!"); }' > hello.fleet

  2. 编译并运行 bash fleet hello.fleet ./hello

  3. 预期输出 Hello, Fleet!

🛠️ 开发工具

构建工具

# 安装 Make（如果未安装）
sudo apt install make  # Ubuntu/Debian
brew install make      # macOS

文档工具

# 安装 Python 和依赖
pip3 install markdown

🔄 更新 Fleet

从源码更新

cd fleet
git pull origin main
cargo build --release

使用包管理器更新

# 如果通过包管理器安装
fleet update  # 即将支持

❌ 卸载

完全卸载

# 删除二进制文件
sudo rm /usr/local/bin/fleet

# 删除配置文件
rm -rf ~/.fleet

# 删除源码目录
rm -rf /path/to/fleet

🐛 故障排除

常见问题

问题: cargo build 失败

解决方案:
1. 确保 Rust 版本 >= 1.70.0
2. 更新 Rust: rustup update
3. 清理缓存: cargo clean

问题: LLVM 链接错误

解决方案:
1. 检查 LLVM 版本: llvm-config --version
2. 设置环境变量: export LLVM_SYS_170_PREFIX=/path/to/llvm
3. 重新构建: cargo clean && cargo build --release

问题: 权限错误

解决方案:
1. 使用 sudo 安装到系统目录
2. 或安装到用户目录: ~/.local/bin/

📞 获取帮助

如果遇到安装问题，可以通过以下方式获取帮助：

🎉 下一步

安装完成后，建议阅读：