先确认PATH是否生效；安装完Go后go version报“command not found”，根本原因是PATH未包含Go的bin目录，需手动验证并source配置或重启终端。
go version 命令不识别？先确认 PATH 是否生效
安装完 Go 后 go version 报 “command not found” 或 “不是内部或外部命令”，基本是 PATH 没生效。Windows 上 MSI 安装器通常会自动写入，但 PowerShell/CMD 会话不会自动继承新环境变量。
- 新开一个终端（不是 Ctrl+T 新标签页，而是彻底关闭再重开）再试
- Windows 用户检查
%PATH%是否含%GOROOT%\bin（比如C:\Program Files\Go\bin），可用echo %PATH%查看 - macOS/Linux 用户改了
~/.zshrc后必须执行source ~/.zshrc，否则只对新登录会话有效 - VS Code 内置终端可能缓存旧环境，重启 VS Code 才能读取最新
PATH
VS Code 的 Go 插件提示 “gopls not installed” 怎么办
gopls 是 Go 官方语言服务器，VS Code Go 插件依赖它提供补全、跳转、诊断等功能。插件常因网络问题或权限限制无法自动安装。
- 手动安装最可靠：
go install golang.org/x/tools/gopls@latest - 安装后检查位置：
which gopls（macOS/Linux）或where gopls（Windows），确保输出路径在PATH中 - 如果提示
GOBIN未设置，建议显式设置：go env -w GOBIN=$HOME/go/bin（macOS/Linux）或go env -w GOBIN=%USERPROFILE%\go\bin（Windows） - VS Code 设置里搜
go.goplsPath，可填绝对路径指向刚装好的gopls，绕过自动探测逻辑
go mod init 初始化失败：module path 不合法
运行 go mod init example.com/myapp 却报错 malformed module path "example.com/myapp": missing dot in first path element，说明模块路径格式不对。
- Go 要求模块路径至少含一个
.，不能是纯字母或带下划线的域名前缀，如myapp、hello_world都非法 - 推荐用真实域名反写（哪怕没注册）：
github.com/yourname/project、gitlab.com/team/proj，本地开发也 OK - 若只是临时测试，可用伪域名：
example.com/hello—— 这是 Go 文档明确允许的占位写法 - 路径中不能含空格、中文或 shell 特殊字符；Windows 路径如
D:\my go\proj会因空格和反斜杠出问题，建议用C:/work/myproj格式
dlv 调试器启动失败：找不到可执行文件
VS Code 点调试按钮后报错 could not launch process: fork/exec ... no such file or directory，常见于项目没 build 出二进制，或 launch.json 配置路径错误。
立即学习“go语言免费学习笔记（深入）”；
- Delve（
dlv）默认调试的是已编译的可执行文件，不是源码。VS Code Go 插件在配置为"mode": "auto"时会尝试自动 build，但失败时不报具体原因 - 先手动跑一次：
go build -o ./main .，再在launch.json中把"program"改成"./main" - 确保
launch.json的"cwd"指向模块根目录（含go.mod），否则dlv可能找不到依赖或工作路径错乱 - Windows 上注意路径分隔符：用
"./main.exe"而非"./main"，且不要用反斜杠\
gopls 依赖 GOROOT 下的标准库，dlv 依赖 go build 输出格式，go mod 又受当前目录是否含 go.mod 影响。任何一个环节路径或版本对不上，就会静默失败。动手前花两分钟确认 go env 输出，比反复重装更省时间。 
