go编译失败却无报错且未生成可执行文件，通常因缺少package main或func main()，或main.go不在当前目录且未显式指定路径；go build仅对含main包的目录生成可执行文件。
go build 编译失败但没报错，实际没生成可执行文件
这种情况通常是因为当前目录下没有 main 函数，或者 main.go 不在根目录且未显式指定。Go 的 go build 默认只编译当前包，而只有包含 func main() 的 main 包才能生成可执行文件。
- 检查是否漏写了
package main和func main()—— 缺一不可 - 如果
main.go在子目录（如cmd/myapp/main.go），必须用路径指定：go build -o myapp ./cmd/myapp - 多个
main包共存时（比如不同命令入口），不能直接go build，否则会报multiple main packages错误 -
go build默认不输出任何信息成功即静默，建议加-x参数看实际执行命令：go build -x ./cmd/api
GOPROXY 配置后 still fails with “no matching versions”
不是代理没生效，而是模块版本语义化或私有仓库没处理好。国内代理（如 https://goproxy.cn）只缓存公开模块，对私有路径、无 tag 提交、或 replace 覆盖的模块无效。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 先确认
go env GOPROXY输出是否含direct（如https://goproxy.cn,direct），缺了就回源失败 - 私有模块（如
git.internal.company.com/lib/utils）需设置GOPRIVATE：go env -w GOPRIVATE=git.internal.company.com/* - 若依赖某 commit 但没打 tag，Go 默认不拉取 —— 可临时用
go get git.example.com/repo@commit-hash指定 - 某些内部镜像（如企业 Nexus）不支持
/@v/list接口，会导致go list失败，此时只能关代理：go env -w GOPROXY=direct
vendor 目录存在但 go build 仍联网拉包
Go Modules 默认忽略 vendor，除非明确启用 vendor 模式。即使有 vendor/，go build 仍会校验 go.sum 并尝试联网验证 checksum —— 这是安全机制，不是 bug。
- 强制使用 vendor：加
-mod=vendor参数，例如go build -mod=vendor ./... - 注意：
go mod vendor不会复制间接依赖（indirect），需提前go mod tidy确保所有依赖已解析 - vendor 后修改代码再
go mod tidy会清空 vendor —— 要同步执行go mod vendor - CI 环境中建议固定 Go 版本（如
1.25.0），不同 Go 版本对 vendor 的处理逻辑有细微差异
交叉编译 Windows/Linux/macOS 可执行文件失败
Go 原生支持跨平台编译，但容易卡在 CGO 或系统库上。纯 Go 项目没问题，一旦用了 cgo（比如调用 SQLite、OpenSSL），就必须匹配目标平台的 C 工具链。
- 禁用 CGO 是最简方案：
CGO_ENABLED=0 go build -o app-linux-amd64 -ldflags="-s -w" ./cmd/app - Windows → Linux：需在 Linux 环境或 WSL 中编译，或用 Docker：
docker run --rm -v $(pwd):/work -w /work golang:1.25-alpine go build -o app-linux ./cmd/app - macOS M-series（arm64）编译 Intel（amd64）二进制：加
GOARCH=amd64，但部分 cgo 库不支持跨架构 -
GOOS和GOARCH必须成对设，单独设一个无效；常见组合：GOOS=windows GOARCH=amd64、GOOS=linux GOARCH=arm64
go run 成功但 go build 出的二进制在另一台机器上 panic，十有八九是环境变量、cgo、或 runtime.GOROOT 路径埋的雷。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
