Leanote编译失败需确保Go版本为1.15–1.20（推荐1.19.13），避免系统包管理器安装，应从go.dev/dl下载tar.gz并正确配置GOROOT；同时检查MongoDB连接配置、代理源及交叉编译参数。
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 环境问题，而是服务依赖未就绪或配置未覆盖。
立即学习“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 自身容器内部
go build 就完事”，它卡点往往不在语法或工具链，而在 Revel 框架生命周期、MongoDB 连接时机、以及跨平台二进制对 libc 的隐式依赖。最容易被忽略的是：修改 conf/app.conf 后必须重启服务，热加载不生效；而 go mod tidy 之后没跑 go mod vendor，在 CI 环境里可能因缺失 vendor 目录导致构建失败。 
