Leanote环境搭建关键在于复用并验证现有Go配置：需确认Go版本≥1.15、GO111MODULE=on、GOPATH有效，清除IDE缓存，强制重载Go工具路径，删vendor/go.sum后go mod tidy，编译时用-ldflags注入confPath，跨平台编译应使用Docker避免syscall错误。
直接用现有配置搭 Golang 环境，关键不是重装，而是复用和验证。Leanote 项目明确要求 Go 1.15+，如果你本地已有 Go，先确认它是否满足，再检查 GOPATH、GOROOT 和模块开关是否与项目实际构建逻辑一致——否则 go build 会静默失败或编译出错。
检查当前 Go 版本与模块状态是否匹配 Leanote 要求
Leanote 的 go.mod 文件锁定了最低兼容版本，不是“能跑就行”，而是“必须满足其依赖解析规则”。常见错误是：本地 go version 显示 1.18，但 GO111MODULE=off 或未设置 GOPATH，导致 go mod download 报 no required module provides package。
- 运行
go version，确认输出包含go1.15或更高（如go1.21.6） - 运行
go env GO111MODULE，输出必须是on；如果不是，执行export GO111MODULE=on并写入 shell 配置 - 运行
go env GOPATH，确保路径不为空且可写（Leanote 依赖部分工具如revel会安装到$GOPATH/bin） - 进入 Leanote 源码根目录，执行
go mod graph | head -n 5，观察是否有大量=>错误指向缺失模块——这是模块启用失败的典型信号
复用已有 GOPATH/GOROOT，但需绕过 IDE 缓存干扰
VS Code 或 Goland 常缓存旧的 GOROOT 路径，即使你改了 ~/.zshrc，重启编辑器前仍可能用错版本。Leanote 使用 Revel 框架，对 GOROOT 下的 src 和 pkg 结构敏感，路径错会导致 revel build 找不到 net/http 等标准库。
- 在终端中执行
which go和go env GOROOT，记录结果 - 在 VS Code 中按
Cmd+Shift+P（Mac）或Ctrl+Shift+P（Linux/Win），输入 “Go: Locate Go Tools”，点击刷新，强制重载环境变量 - 关闭所有终端窗口，新开一个，cd 到 Leanote 目录后，再运行
go build -o leanote .——避免复用之前可能污染的 shell 环境 - 若仍报
cannot find package "github.com/revel/revel"，说明go mod未真正生效，直接删掉项目根目录下的vendor/和go.sum，再跑go mod tidy
定制化编译时传参，避开硬编码路径依赖
Leanote 默认从 conf/app.conf 加载配置，但二进制本身不嵌入路径。如果想让编译出的 leanote 启动时自动读取自定义配置目录（比如 /etc/leanote/conf），不能改源码，而要用 -ldflags 注入变量。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- Leanote 主入口中通常有类似
var confPath = "conf/app.conf"的全局变量，将其改为var confPath string（无默认值） - 编译时用
go build -ldflags "-X 'main.confPath=/etc/leanote/conf/app.conf'" -o leanote . - 注意单引号包裹整个
-X参数，且包路径必须精确到main（或对应 main 包名），变量名区分大小写 - 若项目用了多个包管理配置（如
github.com/leanote/leanote/app），则-X参数要写成-X 'github.com/leanote/leanote/app.confPath=...'
跨版本编译时，别依赖本地 GOROOT/src
Leanote 需要支持 Linux ARM64 部署，但你在 x86_64 Mac 上编译时，若直接设 GOOS=linux GOARCH=arm64 go build，Go 会尝试复用本地 GOROOT/src 中的系统调用定义——而 macOS 的 syscalls 和 Linux 不同，容易触发 undefined: syscall.Statfs_t 类错误。
- 正确做法是：用 Docker 或干净的 Linux 容器做交叉编译环境，或使用官方多平台镜像：
docker run --rm -v $(pwd):/work -w /work golang:1.21 bash -c "GOOS=linux GOARCH=arm64 go build -o leanote-linux-arm64 ." - 不要在本地用
CGO_ENABLED=0强行绕过，Leanote 依赖 cgo 的部分 MongoDB 驱动（如go.mongodb.org/mongo-driver/mongo）可能因此失效 - 验证产物：用
file leanote-linux-arm64确认是 ELF 64-bit LSB executable, ARM aarch64；再用./leanote-linux-arm64 version（如有）或简单启动看是否 panic
最容易被忽略的是 go mod 的隐式行为：当你在非模块根目录下执行 go build，它可能 fallback 到 GOPATH 模式，而不是读取项目里的 go.mod。Leanote 构建失败十次里，七次源于此——务必 cd 进项目根目录再动手，别图省事在父级目录敲命令。
