Go环境是区块链开发的基础设施，需≥1.21版本并正确配置WASM支持、GOPROXY、abigen与solc版本匹配及tinygo target等硬性契约，否则合约编译通过却无法部署或调用。
go 环境本身不直接运行智能合约，但它是开发区块链应用（尤其是与 EVM 交互、构建 WASM 合约、编写链代码）的基础设施。没配好 go，后续所有操作都会卡在第一步。
Go 版本必须 ≥1.19，且要确认 WASM 支持可用
很多教程用 go 1.18 就开始跑 tinygo build -target=wasi，结果报错：build constraints exclude all Go files。这是因为 Go 原生 WASM 支持从 1.21 才稳定，而 tinygo 对 go 1.20+ 的 stdlib 兼容性更可靠。
- 执行
go version，输出必须是类似go version go1.21.0 linux/amd64 - 验证 WASM 能力：
go env GOOS GOARCH应支持wasi或wasm（tinygo用wasi，go原生编译用wasm） - 别用系统包管理器装的
golang（如 Ubuntu 的apt install golang），版本太旧且路径混乱；一律用官方二进制包解压到/usr/local/go
abigen 和 solc 编译器必须匹配，否则生成的 Go 绑定会 panic
你写了个 Storage.sol，用 solc 0.8.26 编译出 Storage.json，但用 abigen（来自 go-ethereum@v1.13.5）生成绑定时却报 invalid ABI: missing method "set"——常见原因是 abigen 版本太老，不识别新版 Solidity ABI 格式。
- 安装
abigen必须指定 commit 或 tag：go install github.com/ethereum/go-ethereum/cmd/abigen@v1.14.0 -
solc推荐用 Docker 运行避免污染系统：docker run --rm -v $(pwd):/contracts ethereum/solc:0.8.26 --abi --bin contracts/Storage.sol -o /contracts/build/ - 生成绑定前，确保
Storage.json中的abi字段是数组、bytecode是 hex 字符串（以0x开头），否则abigen会静默失败
Cosmos SDK 或 Hyperledger Fabric 链代码开发需额外设置 GOPATH 和 module proxy
写一个 chaincode（即 Go 链代码）部署到 Fabric 或 Cosmos 链上，go mod tidy 却反复拉取失败，提示 github.com/hyperledger/fabric-contract-api-go@v2.2.0+incompatible: reading http://proxy.golang.org/...——根本原因是国内网络无法直连 proxy.golang.org，而 Fabric/Cosmos 的依赖又极深。
立即学习“go语言免费学习笔记（深入）”；
- 必须设置 GOPROXY：
go env -w GOPROXY=https://goproxy.cn,direct -
GOPATH不再强制要求，但若项目里用了vendor或旧版 Fabric 工具链，仍需确保$GOPATH/src/github.com/...路径存在 - Cosmos SDK v0.47+ 强制使用 Go modules，
go.mod中的replace规则不能省：replace github.com/cosmos/cosmos-sdk => ./cosmos-sdk（本地调试时）
tinygo 编译 WASM 合约时容易忽略 target 和 ABI 适配
用 tinygo build -target=wasi -o contract.wasm 编译一个 Near 或 CosmWasm 合约，部署后调用直接 trap 或返回空值——问题往往不在逻辑，而在 ABI 层不兼容。
-
-target=wasi适用于 Near、Secret Network；-target=wasm32-wasi是等价写法，但部分旧版tinygo只认前者 - 必须导出函数：用
//export handle_init+func handle_init() int32，且函数签名要严格匹配链上 runtime 要求（例如 CosmWasm 要求handle、query、init三个导出） - 禁用 GC：
-gc=none，否则某些链（如 Secret Network）会因内存模型不兼容 crash
Go 环境看着只是装个编译器，但实际是整条工具链的起点。版本错一位、proxy 少设一个、target 写漏半个字符，都会导致后续合约编译通过却无法部署或调用失败。尤其注意 abigen 和 solc 的组合、tinygo 的 target 与链的 runtime 匹配——这些不是“可选配置”，而是硬性契约。
