go version报command not found是PATH未配置所致，需确认Go安装路径（如/usr/local/go/bin/go），将对应bin目录加入shell配置文件（如~/.zshrc），执行source生效后验证。
go version 报 command not found
这是环境变量没配对最直接的表现，不是 Go 没装，而是 shell 找不到 go 命令位置。
先确认是否真装了：
ls -l /usr/local/go/bin/go
如果存在，说明安装成功；不存在就回去重装。常见错误路径有：
-
/usr/local/go是默认安装路径，但有人手动解压到~/go或/opt/go却忘了改PATH -
~/.bashrc里写了export PATH=$PATH:/usr/local/go/bin，但用的是zsh，实际生效的是~/.zshrc - Mac M1/M2 用户装了 ARM64 版本，却在 Rosetta 终端里运行（或反过来），
file /usr/local/go/bin/go能看出架构是否匹配
修复方式：查清 Go 安装路径后，在对应 shell 配置文件末尾加一行：
立即学习“go语言免费学习笔记（深入）”；
export PATH="/usr/local/go/bin:$PATH"
然后 source ~/.zshrc（或 source ~/.bashrc）再试。
go mod init 报 failed to load config: unknown import path
这不是模块初始化失败，而是当前目录下有 go.mod 文件，但里面写了非法的 module 名——比如含空格、大写字母、下划线，或以数字开头。
典型错误内容：
module my-project_v1
Go 规范要求 module path 必须是合法域名格式（哪怕只是占位），例如：
- ✅
module example.com/myproject - ✅
module github.com/username/repo - ❌
module my_project（下划线不被允许） - ❌
module 123app（不能数字开头）
临时解决办法：删掉现有 go.mod，用正确路径重新 init：
rm go.mod<br>go mod init github.com/yourname/yourrepo
注意：别用本地路径如 /home/user/project，Go 不认这种写法。
gopls 启动失败并报 “no module found”
VS Code 提示 gopls 初始化失败，日志里反复出现 no module found，本质是工作区没识别为 Go 模块项目，而非语言服务器本身坏了。
触发条件很具体：
- 项目根目录没有
go.mod，且不含package main的.go文件（比如只有工具脚本或测试文件） - VS Code 打开的是子目录而非模块根目录（例如打开
./cmd/server，但go.mod在上两级） -
GO111MODULE=off被全局设定了（检查go env GO111MODULE）
验证方法：在项目根目录运行 go list -m，输出应为模块名；若报 not in a module，就是问题所在。
修复优先级：
- 确保
go.mod存在且位置正确 - 在 VS Code 中用「File → Open Folder」打开包含
go.mod的目录，不要只打开单个文件 - 执行
go env -w GO111MODULE=on关闭 GOPATH 模式
dlv debug 报 “could not launch process: decoding dwarf section info”
这个错误几乎只发生在 Go 和 Delve 版本不匹配时，和编译参数关系不大，重点看版本组合。
查版本命令必须一起跑：
go version<br>dlv version
关键兼容点：
- Go 1.25+ 要求
dlv v1.9+，旧版dlv解析不了新 DWARF 5 格式 - Go 1.24 及以下可用
dlv v1.8.1，但别用v1.9.0-rc1这类预发布版 - 如果你用
go install github.com/go-delve/delve/cmd/dlv@latest，很可能装到不兼容的快照版
稳妥做法是明确指定版本安装：
go install github.com/go-delve/delve/cmd/dlv@v1.9.2
另外确认没在构建时加 -ldflags="-s -w"——这会剥离调试信息，dlv 就真的无从下手了。
真正容易被忽略的是：同一台机器上可能同时存在多个 dlv 二进制（比如 Homebrew 装一个、go install 装另一个），which dlv 和 dlv version 输出可能不一致。删干净再重装是最省事的路径。
