go代理必须在安装工具链前配置，即执行go env -w goproxy=https://goproxy.cn,direct确保全局生效；再全选安装gopls、dlv等全部工具并重启vscode；同时路径须为纯英文、无空格，且项目需在模块根目录执行go mod init。
Go 代理必须在安装工具链前配置
VSCode 的 Go 插件在首次启动或执行 Go: Install/Update Tools 时，会尝试从 proxy.golang.org 下载 gopls、dlv 等核心工具。国内直连基本失败，表现为命令卡住、超时、或报错 failed to fetch 或 module lookup failed。这不是插件问题，而是 Go 工具链本身的网络依赖。
关键点：代理必须用 go env -w 写入全局配置，不能只在终端临时设置 GOPROXY 环境变量——VSCode 启动的子进程（如 gopls）不会继承终端的临时变量。
- 在 VSCode 终端（或任意 PowerShell/cmd）中运行：
go env -w GOPROXY=https://goproxy.cn,direct - 验证是否生效：
go env GOPROXY应输出https://goproxy.cn,direct - 如果之前失败过，建议先清理缓存：
go clean -modcache
Go 工具链安装要全选且等完成
VSCode 的 Go: Install/Update Tools 命令（Ctrl+Shift+P 调出）会列出约 10–15 个工具，包括 gopls（语言服务器）、dlv（调试器）、goimports（自动导入管理）等。漏装任一关键项都会导致功能残缺：比如没装 dlv 就无法断点调试；没装 gopls 就没有代码跳转和实时错误提示。
常见误区是勾选后没等完就关掉弹窗，或看到某几个工具进度条卡住就放弃。实际部分工具（如 gopls）下载体积大、校验耗时，需耐心等待 1–2 分钟。
- 务必勾选全部工具，尤其是
gopls、dlv、goimports、gofumpt - 安装完成后，重启 VSCode —— 插件不会自动 reload 语言服务器
- 检查状态栏右下角：若显示
gopls (running)，说明语言服务已就绪
Windows 路径含中文或空格会导致工具静默失败
Go 工具链（尤其是 dlv 和 gopls）在 Windows 上对路径敏感。如果 Go 安装目录（GOROOT）、项目路径、或用户目录（如 C:\Users\张三\）含中文或空格，可能导致调试启动失败、go mod 报错、甚至 gopls 进程崩溃退出，但 VSCode 往往只显示“Language Server crashed”，不报具体原因。
这不是代理或插件问题，而是底层 exec 调用解析路径失败。修复成本低，但排查困难。
- Go 安装时务必选择默认路径（如
C:\Go），不要改到桌面或文档等含空格路径 - 新建项目文件夹名用纯英文，如
hello-go，不要用我的第一个go项目 - 检查
go env GOROOT和go env GOPATH输出，确认路径无中文/空格
模块初始化必须在项目根目录执行
VSCode 的 Go 支持高度依赖 Go Modules。如果直接新建 main.go 并运行，即使代码语法正确，也可能提示 no Go files in current directory 或无法识别 fmt 包——因为当前目录不是合法模块根。
go mod init 不是可选步骤，而是启用现代 Go 开发的必要前提。它生成 go.mod 文件，让 gopls 知道项目边界和依赖范围。
- 在 VSCode 终端中，cd 到项目文件夹（如
D:\hello-go），再执行：go mod init hello-go - 模块名建议与文件夹名一致，避免后期
go run找不到入口包 - 初始化后，
main.go中的package main才会被正确识别为可执行程序
