Go环境变量未生效是因VS Code未加载Shell配置的PATH，需在配置文件中添加Go路径并完全重启VS Code；必须使用golang.go插件和gopls，安装go.mod或go.work启用模块模式；调试需单独安装匹配版本的dlv。
Go 环境变量没生效，go version 报 command not found
VS Code 本身不管理 Go 的环境变量，它依赖系统 Shell 启动时加载的 $PATH。常见问题是：你在终端里能运行 go version，但在 VS Code 里打开集成终端却提示找不到命令——这说明 VS Code 没读取你 Shell 配置文件（如 ~/.zshrc 或 ~/.bash_profile）里的 export PATH。
解决方法：
- macOS / Linux：确保
go的安装路径（比如/usr/local/go/bin或$HOME/sdk/go1.22.0/bin）已写入 Shell 配置文件，并执行source ~/.zshrc；然后**完全退出 VS Code 再重开**（仅重启窗口不够） - Windows：检查系统环境变量中是否已添加
%GOROOT%\bin，且 VS Code 是以新会话启动（避免从旧 cmd/PowerShell 启动） - 验证方式：在 VS Code 集成终端中运行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认包含 Go 的bin目录
Go 插件选 gopls 还是 go（旧版）？
VS Code 官方推荐且唯一维护的 Go 语言服务器是 gopls（Go Language Server）。旧插件 go（由 ms-vscode.go 提供）已在 2022 年归档，不再更新，也不支持 Go 1.21+ 的新特性（如泛型深度补全、go.work 多模块感知）。
必须做的是：
- 卸载已安装的
Go插件（ms-vscode.go） - 安装官方插件：
golang.go（ID:golang.go，发布者为Golang） - 该插件默认启用
gopls，无需手动配置；但需确保本地已安装gopls：运行go install golang.org/x/tools/gopls@latest - 若项目使用
go.work，gopls会自动识别工作区，无需额外设置
gopls 报错 “no modules found” 或无法跳转定义
这是最常被忽略的路径问题：gopls 默认只在有 go.mod 的目录及其子目录下工作。如果你直接打开一个普通文件夹（比如 ~/projects/myapp），但里面没有 go.mod，gopls 就会静默降级为“无模块模式”，导致补全弱、跳转失效、诊断缺失。
解决路径：
- 在项目根目录运行
go mod init example.com/myapp（模块名可任意，只要合法） - 如果项目是多模块，确保上层存在
go.work，并用go work use ./module1 ./module2显式加入 - 不要把 VS Code 工作区设为 GOPATH 下的
src/子目录（如~/go/src/github.com/user/repo）——gopls对 GOPATH 模式支持极差，优先用 module 模式 - 检查 VS Code 设置中是否误禁用了
gopls：搜索go.goplsEnabled，确认为true
调试时断点不命中，dlv 启动失败
VS Code 调试 Go 依赖 dlv（Delve），不是内置组件。即使装了 Go，dlv 也必须单独安装，且版本需匹配 Go 版本。
关键步骤：
- 安装：运行
go install github.com/go-delve/delve/cmd/dlv@latest - 验证：在终端执行
dlv version，输出应含API version: 2（Go 1.21+ 要求 API v2） - VS Code 中调试前，确保当前文件是
main包且含func main()；非main包文件无法直接调试 - 若用
go.work，调试前先运行go work sync，否则dlv可能找不到依赖模块的源码路径 - Windows 用户注意：避免路径含中文或空格，
dlv在某些版本下对此敏感
{
"version": "0.2.0",
"configurations": [
{
"name": "Launch Package",
"type": "go",
"request": "launch",
"mode": "test",
"program": "${workspaceFolder}",
"env": {},
"args": []
}
]
}
调试配置里 "mode": "test" 仅用于测试文件；日常运行请改用 "mode": "exec" 并指定 "program": "./main.go" 或已构建的二进制路径。
真正卡住的地方往往不是插件装没装，而是 go.mod 缺失、dlv 版本过旧、或 VS Code 没读到 shell 的 PATH——这三个点反复检查一遍，90% 的环境问题就解了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
