structsd-install

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

参考资料

• 工具 — 安装 structsd 后的环境配置（服务器、账户设置等）
• structs-onboarding 技能指南 — 玩家创建及首次构建流程（需要使用 structsd）