全面掌握Golang环境搭建及应用服务编译-Golang-PHP中文网

Leanote编译失败需确保Go版本为1.15–1.20（推荐1.19.13），避免系统包管理器安装，应从go.dev/dl下载tar.gz并正确配置GOROOT；同时检查MongoDB连接配置、代理源及交叉编译参数。

全面掌握golang环境搭建及应用服务编译

go version 不匹配 Leanote 编译失败怎么办

Leanote 明确要求 Go ≥ 1.15，但实际编译时 go build 报错或运行异常，大概率是版本不兼容——不是“装了就行”，而是必须匹配项目 go.mod 中声明的最小兼容版本。

执行 go version 确认当前版本；若低于 1.15（如 1.13 或 1.14），必须升级，不能跳过
Leanote 使用 Revel 框架 v1.0.0，该版本在 Go 1.21+ 下存在 reflect.Value.Call 兼容性问题，建议锁定在 1.15–1.20 区间（实测 1.19.13 最稳）
不要用系统包管理器（如 apt install golang）安装：Ubuntu/Debian 的仓库版常删减 src 和 pkg，导致 go build 找不到 unsafe 或 runtime
推荐方式：从 go.dev/dl 下载对应 tar.gz，解压到 /usr/local/go，再重置 GOROOT

GOOS/GOARCH 交叉编译时服务启动失败

本地开发用 macOS，但目标部署是 Linux ARM64 服务器，GOOS=linux GOARCH=arm64 go build 出来的二进制在目标机上报 cannot execute binary file: Exec format error，说明平台适配没生效或 runtime 依赖缺失。

确认构建命令前清空环境变量：env -i GOOS=linux GOARCH=arm64 go build -o leanote-linux-arm64 .，避免残留的 CFLAGS 或 CGO_ENABLED 干扰
Leanote 启动依赖 MongoDB 连接，而默认开启 CGO_ENABLED=1 会链接 libc；交叉编译时需显式关闭：CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -a -ldflags '-s -w' -o leanote-linux-arm64 .
-a 强制重编译所有依赖，-s -w 剥离调试信息和符号表，减小体积并规避部分动态链接问题
验证产物：在目标机器运行 file leanote-linux-arm64，输出应含 ELF 64-bit LSB executable, ARM aarch64

go mod download 总卡在 proxy.golang.org

国内环境下执行 go mod download 卡住、超时或返回 Get "https://proxy.golang.org/...": dial tcp: i/o timeout，本质是模块代理不可达，不是网络不稳定，而是未正确配置镜像源。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

执行 go env -w GOPROXY=https://goproxy.cn,direct（注意逗号后是 direct，不是 https://goproxy.cn 单独一行）
避免混用多个代理：如果之前设过 https://athens.azurefd.net 或其他，先清除：go env -u GOPROXY
Leanote 依赖中含私有模块（如 github.com/revel/revel），direct 部分确保这些地址直连 GitHub，否则会因 404 失败
验证是否生效：go env GOPROXY 输出应为 https://goproxy.cn,direct；再跑一次 go mod download，首次会慢，但后续缓存加速

Leanote 编译后运行报 failed to connect to mongodb

编译成功、./leanote 启动无 panic，但浏览器打不开，日志里反复出现 failed to connect to mongodb://localhost:27017，这不是 Go 环境问题，而是服务依赖未就绪或配置未覆盖。

Leanote 默认读取 conf/app.conf，其中 mongodb.url 是硬编码值；若 MongoDB 不在本地 27017，必须修改该文件，不能只改环境变量
确认 MongoDB 已运行：mongod --version 检查版本（Leanote 兼容 4.4+，但 6.0+ 需关闭 featureCompatibilityVersion 降级）
启动 MongoDB 时加 --bind_ip_all（或明确指定 --bind_ip 0.0.0.0），否则 Leanote 容器内或远程调用会拒绝连接
如果用 Docker 运行 MongoDB，Leanote 的 mongodb.url 必须填容器名（如 mongodb://mongo:27017），而非 localhost——后者指向 Leanote 自身容器内部

Leanote 的编译不是纯 Go 项目那样“go build 就完事”，它卡点往往不在语法或工具链，而在 Revel 框架生命周期、MongoDB 连接时机、以及跨平台二进制对 libc 的隐式依赖。最容易被忽略的是：修改 conf/app.conf 后必须重启服务，热加载不生效；而 go mod tidy 之后没跑 go mod vendor，在 CI 环境里可能因缺失 vendor 目录导致构建失败。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！