| 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 解压操作。在共享系统中，请联系系统管理员。
参考资料
