vs code运行go代码失败主因是go、gopls、dlv未被识别：需确保which go和dlv version在vscode终端有输出，项目根含go.mod，gopls缓存已清且重装，dlv为匹配架构预编译版并加入path，launch.json中program指向具体.go文件。
Go 环境装完不等于能写代码——90% 的卡点不在安装步骤本身，而在 go、gopls、dlv 三者是否真正被你的开发工具（尤其是 VS Code）识别到。只要终端里 go run . 能跑通，VS Code 就没理由报错；反之，报错一定是环境链断在某个环节。
确认 go 命令已全局可用且版本合规
这是所有后续操作的前提。很多问题表面是插件失败，根源其实是 go 命令根本没进 shell 的 PATH，或者版本太低不支持模块（Go 1.16+ 才默认关闭 GOPATH 模式）。
- 在终端运行
go version，输出应为go version go1.21.x darwin/arm64或类似（2026 年建议用 1.21+ LTS 版） - 运行
which go，确保返回路径有效（如/usr/local/go/bin/go）；若为空，说明 shell 启动时没加载环境变量文件（macOS/Linux 是~/.zshrc，Windows 是系统 Path） - 别手动硬写
GOROOT到 VS Code 的settings.json—— 正确做法是：从终端执行code .启动 VS Code，它会继承当前 shell 环境；或在设置中加"go.toolsEnvVars": { "GOROOT": "/usr/local/go" }（路径以go env GOROOT输出为准）
验证模块系统与代理是否就绪
Go 1.16+ 默认启用模块（module），但若 GOPROXY 配置失效，go mod download 会卡住不动，导致 gopls 初始化失败、VS Code 右下角状态栏一直显示 “Initializing…”
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 运行
go env GOPROXY，理想输出是https://goproxy.cn,direct（国内推荐）或https://proxy.golang.org,direct（官方） - 若返回空或
off，立即执行：go env -w GOPROXY=https://goproxy.cn,direct - 若项目涉及私有仓库（如
git.internal.company.com/mylib），必须补上：go env -w GOPRIVATE=git.internal.company.com/*，否则 gopls 会试图走代理查它并超时 - 新建项目时，务必在空目录下先执行
go mod init myapp，再打开该目录 —— gopls 不认单个.go文件，只认含go.mod的 module 根目录
装对 dlv 并让 VS Code 找得到
调试失败报 “could not find Delve” 不代表没装，而是 VS Code 启动时没看到 dlv 二进制，或架构不匹配（比如 macOS ARM64 上装了 x86_64 的 dlv）。
- 手动安装：
go install github.com/go-delve/delve/cmd/dlv@latest - 验证安装：
dlv version应输出版本号；which dlv返回路径必须在$PATH中（通常是$GOBIN/dlv，而$GOBIN应已加入 PATH） - Windows 用户注意：PowerShell 里运行
go install后，需重启 VS Code（或整个 PowerShell），否则新生成的dlv.exe不会被识别 - ARM64 Mac 或 WSL 下若报
fork/exec: no such file or directory，大概率是系统缺少libc兼容层，换用go install安装的原生二进制即可，无需额外编译
最容易被忽略的是：VS Code 的内置终端（Ctrl+`）和图形界面启动方式是两套环境变量加载逻辑。哪怕你改好了 ~/.zshrc，直接双击图标启动 VS Code 仍可能读不到。所以——永远优先从终端输入 code . 打开项目，这是最稳的起点。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
