Windows Server上go命令在服务中找不到，因系统服务不读用户环境变量，需用setx /M配置系统级PATH和GOPATH，并确保IIS启用Load User Profile或NSSM手动设置环境变量。
Windows Server 上 go 命令找不到？先确认系统级 PATH
服务进程（如 IIS 应用池、NSSM 托管的 Go 服务）默认不读取用户环境变量，go version 在 CMD 里能运行 ≠ 服务里能调用 go build 或 go install。
- 用管理员权限运行：
setx /M PATH "%PATH%;C:\Go\bin"和setx /M GOPATH "C:\gopath"（路径按实际安装调整） - IIS 应用池必须开启
Load User Profile = True，否则即使设置了用户级 PATH 也不生效 - NSSM 配置服务时，在
Environment标签页手动添加PATH和GOPATH变量，不能依赖继承 - 验证方式：在服务上下文里执行
cmd /c "go version"，不是在你自己的终端里
Linux 服务器上 go 版本太旧？别碰 apt/dnf 安装包
Ubuntu/Debian 自带的 apt install golang 通常只提供 go1.18 或更老版本，无法支持 embed、泛型约束等特性，且与项目 go.mod 中声明的 go 1.21+ 冲突。
- 必须从官网下载
go1.22.5.linux-amd64.tar.gz（ARM64 选linux-arm64.tar.gz），解压到/usr/local/go -
GOROOT必须设为/usr/local/go，GOPATH别设成/usr/local/go——这会破坏标准库查找路径 - 配置全局生效：
/etc/profile.d/golang.sh中写入export PATH=$GOROOT/bin:$GOPATH/bin:$PATH - 国内服务器务必加代理：
go env -w GOPROXY=https://goproxy.cn,direct，否则go mod download会卡死
静默编译部署：CGO_ENABLED=0 和 -ldflags "-s -w" 是刚需
后台服务不需要 cgo（比如 sqlite、openssl 等 C 依赖），启用它反而导致交叉编译失败、二进制体积膨胀、运行时动态链接失败。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 编译前强制关闭：
CGO_ENABLED=0（Linux/macOS）或set CGO_ENABLED=0（Windows CMD） - 生产环境必加链接参数：
-ldflags "-s -w"，移除调试符号和 DWARF 表，体积减少约 20%，且防反编译 - 交叉编译示例（Windows 上编译 Linux 服务）：
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -ldflags "-s -w" -o mysvc - 输出文件直接 scp 到服务器即可运行，无需安装 Go 环境——这是 Go 静态链接的核心优势
systemd 启动失败？检查 WorkingDirectory 和权限
Go 二进制常依赖当前工作目录下的配置文件（如 config.yaml）、静态资源（dist/）或日志路径，systemd 默认工作目录是 /，不是你的部署目录。
立即学习“go语言免费学习笔记（深入）”；
- service 文件中必须显式指定：
WorkingDirectory=/opt/mysvc - 确保二进制有执行权限：
chmod +x /opt/mysvc/mysvc - 若程序监听端口
:80或:443，systemd 里要加CapabilityBoundingSet=CAP_NET_BIND_SERVICE并去掉User=nobody（或改用非特权端口） - 日志别写死绝对路径，用
StandardOutput=journal+journalctl -u mysvc查，比重定向到文件更可靠
