10分钟上手Solod:从安装so命令到构建Hello World的完整快速开始教程
10分钟上手Solod:从安装so命令到构建Hello World的完整快速开始教程
Solod 是一款 Go 转 C 转译工具:你写的是标准 Go 代码,输出的却是可读的 C11 代码。本教程带你走通 10 分钟路径——从安装 so 命令,到把 Hello World 程序转译为 C 并一键编译运行,全程只需 4 个步骤。
Solod 是什么:Go 进、C 出的转译工具
一句话概括:Solod 是 Go 的一个严格子集,能翻译成普通 C 代码。它特别适合两类人:
- 🧑💻 Go 开发者:想在系统层面掌控内存与性能,又不想从零学 C
- 🛠️ C 开发者:喜欢 Go 的安全语法与工具链,但目标是 C 项目
核心特性一览:
| 特性 | 说明 |
|---|---|
| Go 进,C 出 | 写普通 Go,得到可读 C11 源码 |
| 零运行时 | 无垃圾回收、无引用计数、无隐藏内存分配 |
| 自带标准库 | so/mem、so/slices、so/conc 等从 Go stdlib 移植的包 |
| 原生 C 互操作 | Solod 调 C、C 调 Solod,无需 CGO、零开销 |
| 兼容 Go 工具链 | 语法高亮、LSP、lint、module 直接可用 |
设计上的一切取舍可参考 doc/design.md。
准备工作:环境要求清单
开始前确认两样东西:
- Go 工具链:安装 Go(项目
go.mod声明go 1.26,建议使用 1.26 及以上版本) - C 编译器:GCC 或 Clang 均可,
so build默认调用CC环境变量指向的编译器(默认cc)
支持的操作系统与平台:Linux、BSDs、macOS、Windows;amd64、arm64、riscv64、i386、wasm32。注意不支持 MSVC。
第一步:一条命令安装 so 命令
在终端执行:
go install solod.dev/cmd/so@latest
安装完成后,so 命令会出现在你的 GOPATH/bin 中(如未加入 PATH,请手动添加)。用版本命令验证安装是否成功:
so version
该命令会打印类似 so version x.x.x 的输出。so 的所有子命令实现在 cmd/so/main.go 中。
第二步:创建 Go 项目并编写 Hello World
新建一个目录并初始化为 Go module,然后引入 Solod 标准库:
mkdir solod-hello && cd solod-hello
go mod init example
go get solod.dev@latest
在目录下创建 main.go,写入仓库示例中的 Hello World 程序(完整源码见 testdata/hello-world/src/main.go):
package main
func main() {
println("hello world")
}
注意两点:只使用 Go 语法(这是硬性要求),以及需要 Solod 包时导入 solod.dev/so/... 路径而非标准库。
第三步:so translate 查看生成的 C 代码
这是 Solod 最直观的"魔法时刻"。在项目根目录执行:
so translate -o generated .
generated 目录里会生成 main.h 和 main.c。其中 main.c 的内容非常短(参考 testdata/hello-world/dst/main.c):
#include "main.h"
int main(void) {
so_println("%s", "hello world");
return 0;
}
转译出的 C 代码保留了注释和结构,可读性远好于常见的自动生成产物——这正是 Solod 的设计目标之一。
第四步:so build 与 so run 一键编译运行
如果不想手动管理 C 文件,可以一步到位:
# 转译 + 编译,输出可执行文件
so build -o main .
# 运行刚生成的可执行文件
./main
# 输出:hello world
# 或者:转译、编译、运行一气呵成,不留二进制
so run .
so build 使用 CC 指定的编译器(默认 cc)并默认 -O2 优化,详细构建选项见 doc/building.md。
so 命令速查表
| 命令 | 作用 | 常用参数 |
|---|---|---|
so translate |
将包转译为 C 代码 | -o 输出目录 |
so build |
转译并编译为可执行文件 | -o 输出文件、-check 检查模式 |
so run |
转译、编译并直接运行 | -panic 退出模式 |
so test |
运行 test 子目录中的测试 |
-check=sanitize 内存检查 |
so bench |
运行基准测试 | -run 前缀筛选 |
so version |
查看编译器版本 | — |
⚠️ 一个重要约定:所有命令操作的是 Go module 目录,而不是单个文件——写 so run .,而不是 so run main.go。
常见坑位:新手避坑指南
- ❌ 忘记
go get solod.dev@latest:只装了so命令、没引入标准库依赖,用到so/包时会报导入错误 - ❌ 对单个文件执行命令:如
so run main.go会失败,请始终传包目录. - ❌ 依赖 C++ 或 MSVC:Solod 生成的是 C11 代码,依赖 GCC/Clang 扩展(如二进制字面量、
__attribute__((constructor))),MSVC 不受支持 - ❌ 期望垃圾回收:一切默认栈分配,需要堆内存时请显式使用 so/mem/ 的分配器
下一步:深入学习的资源清单
跑通 Hello World 后,推荐按以下路径继续:
- 📖 语言特性全览:doc/spec.md(语言之旅,包含结构与限制说明)
- 📚 标准库文档:doc/stdlib.md,源码位于 so/ 目录,如 so/fmt/、so/strings/
- 🧪 测试指南:doc/testing.md,用
so test+so/testing包写测试 - ❓ 常见问题:doc/faq.md(内存模型、与 TinyGo 的区别、稳定性等)
- 🌐 在线体验:不想装环境的话,可用 Solod Playground 在线运行代码并查看转译结果
至此,你已经掌握了 Solod 完整工作流的核心:go install 装工具 → 写 Go → so translate 看 C → so run 运行。10 分钟,Go 写 C,就这么简单。