go version能跑通≠项目能跑通，根本原因是go 1.16+默认启用模块模式，缺少go.mod导致工具链无法识别项目边界；必须在项目根目录执行go mod init初始化模块，并确保go build等命令在该目录下运行。
go version 能跑通 ≠ 项目能跑通
很多用户执行 go version 看到输出就以为环境齐了，结果 go run main.go 报错 “no Go files in current directory” 或 VS Code 里全是红色波浪线。根本问题不是 Go 没装好，而是当前目录缺少 go.mod —— Go 1.16+ 默认启用模块模式，没有它，工具链无法识别项目边界、解析依赖、启动 gopls。
必须在项目根目录下执行：
-
go mod init example.com/myapp（模块名可任意，但建议用域名格式，避免冲突） - 生成
go.mod后再写main.go，不要先写代码再补go mod init - 如果已建好文件夹但忘了初始化，进该目录补上命令即可，VS Code / Trae 通常几秒内自动重载
VS Code 或 Trae 里没语法提示、跳转失效
这不是编辑器问题，是语言服务器 gopls 没跑起来。它不随 Go 安装包自带，必须手动安装且路径要进 PATH。
常见卡点：
-
go install golang.org/x/tools/gopls@latest执行失败？先设代理：go env -w GOPROXY=https://goproxy.cn,direct - 安装后二进制默认落在
$GOPATH/bin/gopls（Windows 是%GOPATH%\bin\gopls.exe），该路径必须在系统PATH中 - 验证方式：打开任意
.go文件，底部状态栏应显示gopls (running)，不是(starting)或空白
go run main.go 成功，但 go build 出的二进制一运行就 panic
典型错误是 panic: failed to initialize module，尤其出现在用了 embed、io/fs 或调用 runtime/debug.ReadBuildInfo() 的场景。原因不是代码写错了，而是构建时没在模块上下文中执行。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
关键动作：
- 确保
go build命令在有go.mod的目录下运行，而不是子目录或桌面路径 - 推荐统一用
go build -o myapp .（末尾的.表示当前模块），别用go build main.go - 如果项目含内嵌资源（如 HTML、JSON），检查
//go:embed上方是否少了空行，且文件路径相对于模块根目录
F5 调试直接报 “no such file or directory”
VS Code / Trae 的调试器（dlv）不看文件名，只认工作区能否解析出可执行入口。最常踩的坑是：焦点没放在 main.go 上，或 main.go 不在模块根目录。
排查步骤：
- 按 F5 前，确认编辑器标签页正打开的是含
package main和func main()的文件（通常是main.go） - 确认该文件和
go.mod在同一级目录，且go.mod里module名与实际路径一致 - 运行
go install github.com/go-delve/delve/cmd/dlv@latest，并确保其路径也在PATH中 - 首次调试弹出配置时，选
Go: Launch Package，不要选Go: Launch File
真正卡住人的从来不是语法，而是模块上下文缺失、工具链路径未暴露、调试入口不匹配这三类隐性断点。它们不报错，但让一切“看起来像在工作”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
