10分钟上手Solod:从安装so命令到构建Hello World的完整快速开始教程

原创2026-10-14 20:42:501,456 阅读

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。

准备工作:环境要求清单

开始前确认两样东西:

  1. Go 工具链:安装 Go(项目 go.mod 声明 go 1.26,建议使用 1.26 及以上版本)
  2. 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,就这么简单。

登录后查看全文
solod