| name | structsd-install |
| description | 从源代码安装 `structsd` 二进制文件。涵盖了 Go 语言、`Ignite CLI` 的使用,以及为 Linux 和 macOS 系统构建 `structsd` 的过程。适用于以下情况:`structsd` 未被找到时;在设置新机器时;或者当代理需要安装或更新 `Structs` 链接二进制文件时。 |
安装 structsd
使用 Ignite CLI 从源代码构建 structsd 可执行文件。完成此步骤后,structsd 将会出现在您的系统路径(PATH)中。
先决条件
需要两个依赖项:Go 1.24.1+ 和 Ignite CLI。
1. 安装 Go
Linux (amd64)
wget https://go.dev/dl/go1.24.1.linux-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.24.1.linux-amd64.tar.gz
rm go1.24.1.linux-amd64.tar.gz
如果之前通过 apt 安装了较旧版本的 Go,请先卸载它:sudo apt remove -y golang-go
macOS (Apple Silicon)
curl -OL https://go.dev/dl/go1.24.1.darwin-arm64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.24.1.darwin-arm64.tar.gz
rm go1.24.1.darwin-arm64.tar.gz
macOS (Intel)
curl -OL https://go.dev/dl/go1.24.1.darwin-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.24.1.darwin-amd64.tar.gz
rm go1.24.1.darwin-amd64.tar.gz
或者在 macOS 上使用 brew 安装 Go 1.24:brew install go@1.24
配置系统路径(PATH)
将 Go 的安装路径添加到 ~/.profile(或在 macOS 上的 ~/.zshrc)文件中:
export PATH=$PATH:/usr/local/go/bin:~/go/bin
重新加载配置文件:source ~/.profile(或在 macOS 上的 source ~/.zshrc)
验证安装结果
go version
预期输出:go version go1.24.1 linux/amd64(或 darwin/arm64 等)
2. 安装 Ignite CLI
curl https://get.ignite.com/cli! | bash
验证安装结果
ignite version
3. 构建 structsd
克隆仓库并编译代码:
git clone https://github.com/playstructs/structsd.git
cd structsd
ignite chain build
编译后的二进制文件将被安装到 ~/go/bin/structsd 目录下。由于 ~/go/bin 已经被添加到系统路径中(步骤 1 中已完成配置),因此 structsd 可以立即使用。
验证安装结果
structsd version
4. 更新 structsd
要更新到最新版本,请执行相应的命令:
cd structsd
git pull origin main
ignite chain build
快速检查
按顺序运行所有验证步骤:
go version && ignite version && structsd version
如果任何命令失败,请返回到相应的步骤重新操作。
故障排除
structsd: 命令未找到 — 确保 ~/go/bin 在系统路径中。运行 ls ~/go/bin/structsd 以确认二进制文件存在。
ignite: 命令未找到 — 重新运行 Ignite CLI 的安装命令。curl 命令会将 Ignite CLI 安装到 /usr/local/bin/ignite 目录下。
go: 命令未找到 — 确保 /usr/local/go/bin 在系统路径中。重新加载 shell 配置文件。
- 构建过程中出现 Go 版本错误 — 确保
go version 显示的是 1.24.1 或更高版本。较低版本的 Go 不兼容。
- 在
/usr/local 目录上没有执行权限 — 使用 sudo 来执行 tar 解压操作。在共享系统中,请联系系统管理员。
参考资料