入门

安装 Hew 并编写你的第一个程序。

快速安装

安装 Hew 最快的方法是使用安装脚本：

v0.9.3 · 发布版本

Terminal

curl -fsSL https://hew.sh/install | bash -s -- --version 0.9.3

Terminal

curl -fsSL https://hew.sh/install | bash -s -- --version 0.9.3

PowerShell

Invoke-WebRequest https://hew.sh/install.ps1 -OutFile install.ps1
.\install.ps1 -Version 0.9.3

安装程序会安装 hew，其中包含编译器和包管理器。

在此终端中将默认安装目录加入 PATH。要在以后的终端中使用，请执行安装程序为你的 shell 显示的永久配置命令。如果选择了其他目录，请使用它对应的 PATH 命令。

Terminal

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

这些命令选择与课程相同的编译器版本。运行 hew version 检查安装。

Terminal

hew version

你好，世界

创建名为 hello.hew 的文件：

hello.hew

fn main() {
    println("Hello, world!");
}

编译并运行

使用 hew build 编译，然后运行生成的二进制文件：

原生构建需要 C 编译器和系统开发工具。macOS 使用 Xcode Command Line Tools；Linux 使用 Clang 或 GCC；Windows 使用 LLVM 和 Visual Studio C++ Build Tools。如果检查成功但链接失败，请参阅故障排查指南（英文）。

Terminal

hew check hello.hew
hew build hello.hew -o hello
./hello

输出

Hello, world!

hew build 命令运行 Rust frontend，将检查后的程序依次降低为 HIR 和 MIR，并通过 LLVM 生成原生二进制文件。

配置编辑器

在 VS Code 的扩展中安装 Hew Language（hew-lang.hew-lang）。如果 code 命令已在 PATH 中，也可以运行：

Terminal

code --install-extension hew-lang.hew-lang

打开 hello.hew。语言模式应为 Hew，并显示语法高亮和语言服务器诊断。已发布的扩展包含适用于受支持平台的 hew-lsp。

要使用指定安装，在 VS Code 设置中将 hew.lsp.serverPath 和 hew.formatterPath 设为 hew-lsp 和 hew 的完整路径。请使用不含 ~ 或变量的绝对路径。修改 PATH 后重新启动 VS Code。

Vim、Neovim、Emacs 和其他编辑器（英文）

继续阅读语言导览

导览用简短示例介绍函数、record、pattern matching、actor 调用和并发操作。

打开语言导览 →

快速参考表

可打印的双面参考表涵盖常用语法、actor、并发、wire type 和 machine。

下载 PDF

其他安装方式

要在运行前检查安装程序，请先下载到本地文件并阅读。

Terminal

curl -fsSLo hew-install.sh https://hew.sh/install
less hew-install.sh
bash hew-install.sh --version 0.9.3

下载上方所示的版本，并使用对应的 SHA-256 校验和文件验证平台归档。

Terminal

tag=v0.9.3
asset=hew-v0.9.3-darwin-aarch64.tar.gz # choose the asset for your Mac
base="https://github.com/hew-lang/hew/releases/download/$tag"
curl -fLO "$base/$asset"
curl -fLO "$base/hew-$tag-checksums.txt"
grep "  $asset$" "hew-$tag-checksums.txt" | shasum -a 256 -c -

Terminal

tag=v0.9.3
asset=hew-v0.9.3-linux-x86_64.tar.gz # choose the asset for your Linux host
base="https://github.com/hew-lang/hew/releases/download/$tag"
curl -fLO "$base/$asset"
curl -fLO "$base/hew-$tag-checksums.txt"
grep "  $asset$" "hew-$tag-checksums.txt" | sha256sum -c -

PowerShell

$tag = "v0.9.3"
$asset = "hew-v0.9.3-windows-x86_64.zip"
$base = "https://github.com/hew-lang/hew/releases/download/$tag"
Invoke-WebRequest "$base/$asset" -OutFile $asset
Invoke-WebRequest "$base/hew-$tag-checksums.txt" -OutFile checksums.txt
$expected = (Select-String -Path checksums.txt -Pattern " $asset$").Line.Split(" ")[0]
$actual = (Get-FileHash -Algorithm SHA256 $asset).Hash.ToLower()
if ($actual -ne $expected) { throw "checksum mismatch" }

也可以准备下方所列的工具，从源码构建指定的发布版本。

Using the mobile apps? Follow the illustrated iPhone/iPad guide or Android beta guide for examples, editing, running and saving code. These guides are in English.

前置条件

从源码构建还需要 GNU Make 和 Python 3.12 或更高版本。查看完整构建要求（英文）。

从源码构建 Hew 编译器需要 LLVM 22 和 Rust toolchain。在 Ubuntu/Debian 上：

Terminal

# Install LLVM 22 (required by Inkwell)
wget https://apt.llvm.org/llvm.sh && chmod +x llvm.sh && sudo ./llvm.sh 22

# Install build tools
sudo apt install cmake ninja-build

从源码构建

克隆 repository 并构建 compiler：

Terminal

git clone --branch v0.9.3 https://github.com/hew-lang/hew.git
cd hew
make hew-native

Compiler driver 位于 target/debug/hew。将它加入你的 PATH：

Terminal

export PATH="$PWD/target/debug:$PATH"

← 返回文档语言导览 →