5 分钟上手 Goose:从零安装到运行第一个程序的完整指南
5 分钟上手 Goose:从零安装到运行第一个程序的完整指南
Goose 是一门内存安全的系统编程语言:没有堆分配器、没有垃圾回收、没有生命周期注解,却在基准测试中比 C++ 和 Rust 更快、更省内存。本文是一份完整的 Goose 入门指南,带你从安装 Goose 编译器,到 5 分钟内运行第一个 Goose 程序,并掌握最常用的命令与学习资料。
一、Goose 是什么?为什么值得上手 🦆
Goose(项目主页说明)由系统程序员设计,面向追求极致性能与安全性的场景。用一句话概括它的核心卖点:
| 特性 | 说明 |
|---|---|
| ⚡ 高性能 | 16 个基准测试下,平均比惯用 C++ 快约 3.3 倍,比最优秀的安全 Rust 快约 1.1 倍 |
| 🛡️ 内存安全 | 编译器静态推断所有引用,零注解、无悬垂指针,也无需 unsafe 块 |
| 📦 无 GC 无堆 | 动态数据全部内联存放在编译器分配的"数据栈"上,作用域结束即释放 |
| 🔗 稳定引用 | 数组增长时,已有引用依然有效——这在 C++ 和 Rust 中很难做到 |
| 🐹 编译到 C | 整个程序编译为一个 C 文件,只要有 C 编译器就能跑 |
语法上,Goose 对 C 和 Rust 程序员非常友好:大括号、let、fn、struct、match 都有,主要差异在于数组与内存模型。零基础或刚学完一门系统语言的你,完全可以在 5 分钟内跑起第一个程序。
二、安装 Goose:两种方式任选 📦
Goose 官方提供 Windows(x64)、Linux(x64)和 macOS(Apple 芯片与 Intel)三种平台的预编译编译器,也支持从源码构建。
方式一:下载预编译包(新手推荐)
- 从项目 releases 页面下载对应系统的压缩包;
- 解压到任意目录,并将该目录加入系统
PATH; - 打开终端验证:
goose --help
编译器会自动在自身旁边找到标准库、内置 TinyCC 运行时和图形/音频/物理包,构建产物统一放在 ~/.goose(可用环境变量 GOOSE_HOME 修改)。
💡 环境要求:在 Linux 上直接运行程序需要 C 库头文件(
libc6-dev或glibc-devel,且 glibc ≥ 2.35);在 macOS 上需安装 Xcode 命令行工具(xcode-select --install)。
方式二:从源码构建
构建需要 CMake 3.27+、一个 C++20 编译器(MSVC / clang / gcc)和 Python 3(用于测试脚本)。TinyCC 已内置在代码树中,无需额外安装:
git clone https://gitcode.com/gh_mirrors/goose29/goose
cd goose
cmake -B build -DCMAKE_BUILD_TYPE=Release -DGOOSE_BUILTIN_LIBS=all
cmake --build build --config Release
参数 -DGOOSE_BUILTIN_LIBS=all 会把图形、音频、UI、物理等扩展包一并编译进编译器(CMakeLists.txt 中定义了完整的构建选项)。构建完成后,编译器位于 build/goose。
三、运行你的第一个 Goose 程序 🚀
创建一个 hello.goose 文件,只有一行逻辑:
fn main() {
print("hello, goose");
}
Goose 的 print 接受任意多个任意类型的参数,自动拼成一行输出,不需要格式化字符串。然后有两种运行方式:
方式 A:进程内直接运行(最快,开发期推荐)
goose hello.goose
编译器内置的 TinyCC 后端会在编译器进程内完成编译并运行,无需任何额外构建步骤。
方式 B:编译为独立可执行程序
goose build hello.goose && ./hello
goose build 会把程序编译成 C、再用机器上的 C 编译器链接出可执行文件,直接放在源文件旁边。需要多线程的程序请走这条路(TinyCC 无法放置线程本地存储)。
两种方式都应该打印出 hello, goose——恭喜,你已经完成了 Goose 入门!🎉
四、常用 Goose 命令速查 ⌨️
| 命令 | 作用 |
|---|---|
goose hello.goose |
进程内直接运行(等价于 goose run) |
goose check hello.goose |
只做类型检查,不生成程序 |
goose build hello.goose |
编译出独立可执行文件 |
goose toolchain |
查看编译器选择用了哪个 C 编译器 |
goose hello.goose -O2 |
提高内联优化级别(-O0 / -O1 / -O2) |
goose build hello.goose --dry-run |
只打印构建命令,不真正执行 |
小技巧:-v 可以实时打印构建过程,--debug 会在生成的 C 中开启溢出与越界检查,出错时直接告诉你源码行号,排错非常顺手。
五、跟着官方示例学 Goose 📚
仓库自带 31 个完整示例程序,从语言巡礼到 JSON 解析器、多线程 Mandelbrot、GPU 旋转立方体一应俱全(samples/README.md):
# 直接跑第一个官方示例
goose samples/01_tour.goose
# 批量运行全部示例并校验输出
python samples/run_samples.py
推荐按顺序阅读:01_tour.goose 是语言巡礼,07_sieve.goose 讲循环,12_huffman.goose 讲数据结构,19_vm.goose 讲虚拟机——每个文件都可以独立运行。
六、编辑器配置:让 Goose 编码更顺滑 ✨
仓库内置了 VS Code 扩展,提供语法高亮、语言服务器(goose lsp,边写边报错、跳转定义、自动补全、重命名)和一键运行:
code --install-extension vscode/goose-language.vsix
如果你用 Neovim、Helix 或 Emacs,docs/editors.md 里有现成的 goose lsp 接入配置。
七、下一步学习路线 🗺️
跑通 Hello Goose 之后,建议按这条路线深入:
- 官方教程:docs/tutorial.md —— 通过示例讲解数据栈、数组家族、相对引用等核心概念,必读;
- 语言参考手册:docs/reference.md —— 按主题覆盖全部特性,每个特性都带可编译示例;
- 语言规范:docs/goose_spec.md —— 想弄清"为什么不能这样写"时的权威答案;
- 标准库:stdlib/ 下有
json、math、regex、os等 14 个模块,全部是 Goose 代码,可以直接阅读学习; - 性能数据:bench/results.md 收录了全部基准测试的测量结果,看看 Goose 的快到底来自哪里。
总结:安装 Goose 只需"解压加 PATH"三步,运行第一个程序只需一条 goose hello.goose 命令。它的编译到 C 的路线让它能运行在任何有 C 编译器的地方,而无 GC、无堆的内存模型则保证了接近手调 C++ 的性能。现在就去 samples/ 里挑一个示例跑起来吧!
