根本原因是go.mod声明的模块路径与实际import路径不匹配，且缺失依赖未通过go mod tidy下载；需确保module名与import前缀一致、运行go mod tidy，并避免gopath模式混用。

go mod init 之后为什么 go run . 报错找不到包？

根本原因不是命令写错了，而是 go.mod 文件里声明的模块路径和当前目录结构不匹配。比如你在 /home/user/myproj 下执行 go mod init example.com/myapp，但项目里又用了 import "github.com/xxx/lib" 这类第三方路径，而本地没 go get 过，go run . 就会报 cannot find package。

实操建议：

go语言参考手册 中文CHM版

Go 是一个开源的编程语言，它能让构造简单、可靠且高效的软件变得容易。本文给大家带来Go参考手册，需要的可以来下载！ Go是从2007年末由Robert Griesemer, Rob Pike, Ken Thompson主持开发，后来还加入了Ian Lance Taylor, Russ Cox等人，并最终于2009年11月开源，在2012年早些时候发布了Go 1稳定版本。现在Go的开发已经是完全开放的，并且拥有一个活跃的社区。 Go 语言特色 简洁、快速、安全 并行、有趣、开源 内存管理、v数组安全、编译

下载

• 检查 go.mod 第一行 module 声明是否与你实际导入路径一致（尤其注意大小写、斜杠方向）
• 运行 go mod tidy 自动下载缺失依赖并清理未用项，别跳过这步
• 如果引用的是本地子模块（如 ./internal/utils），确保该目录下有 .go 文件且包名不为 main
• 避免在 GOPATH 模式下混用 Modules —— 现代项目必须关掉 GO111MODULE=off

GoLand 启动卡顿、代码补全慢，怎么改 goland.vmoptions？

默认配置对中大型 Go 项目明显吃力，尤其是开启 go vet、gopls 和多 module 依赖索引时。关键不是堆内存越大越好，而是要匹配硬件和项目规模。

实操建议：

• 先备份原 goland.vmoptions（路径通常为 GoLand 2024.1.4\bin\goland.vmoptions）
• 把 -Xms 设为 2048m，避免启动时反复扩容；-Xmx 根据物理内存设，32GB 机器建议 8192m～9216m，别超总内存 1/2
• 加上 -XX:ReservedCodeCacheSize=2048m，否则 gopls 编译缓存频繁抖动，补全延迟明显
• 如果开了大量插件（比如 Kubernetes、Database Tools），顺手加 -XX:MaxDirectMemorySize=6G 防止堆外内存溢出
• 改完重启 GoLand，别指望热加载生效

vscode-go 插件提示 “gopls not found” 或反复崩溃

这不是插件问题，是 gopls 版本和 Go SDK 不兼容。vscode-go 默认自动安装 gopls，但它只认特定 Go 版本范围 —— 比如 Go 1.23.x 需要 gopls v0.15+，而旧版 gopls 会直接 panic。

实操建议：

• 终端运行 go install golang.org/x/tools/gopls@latest 手动更新，别信插件内置的“自动安装”
• 在 VS Code 设置里搜 go.goplsPath，填绝对路径，例如 /home/user/go/bin/gopls，强制指定二进制位置
• 禁用 go.useLanguageServer 以外的 lint 工具（如 staticcheck），它们和 gopls 冲突概率高
• 如果项目含 cgo 或嵌入汇编，加环境变量 GOPLS_NO_PROTOCOL_BUFFERS=1 启动 vscode，避开 protobuf 解析失败

go build -o 输出文件在 Windows 上没有 .exe 后缀？

这是 Go 的跨平台设计特性，不是 bug。Go 编译器根据目标 OS 自动决定可执行文件后缀：Linux/macOS 不加后缀，Windows 加 .exe。但如果你显式写了 -o myapp，它真就叫 myapp，哪怕在 Windows 上。

实操建议：

• 想确保 Windows 下带后缀，就写 go build -o myapp.exe，别省略
• CI/CD 脚本里统一用 go build -o bin/app${GOOS}${GOARCH}，靠 GOOS 变量控制命名（GOOS=windows 时自动拼 .exe）
• 别依赖文件扩展名判断可执行性 —— Windows 下没有后缀也能双击运行（只要注册了文件关联），但分发时加 .exe 更符合用户直觉
• 注意 go run 不受此影响，它始终临时生成并执行，后缀无关紧要

调参这事看着是改几个数字，实际每项参数背后都连着 JVM 行为、gopls 内存模型、Go 工具链调度逻辑。改完不验证等于白调 —— 至少跑一次 go build -v 和开个新文件触发补全，才能确认是不是真生效。

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