windows上用vs code跑go只需三步：装go、配goproxy、装go扩展；现代go（1.16+）无需手动配gopath或path，但安装后须重启终端以生效path；go mod init要求目录下已有.go文件；vs code中跳转失效多因gopls未启动，需安装官方go扩展并重装gopls；go run必须在go.mod所在目录执行。
Windows 上用 VS Code 跑 Go，只要三步就能跑通：装 Go、配 GOPROXY、装 Go 扩展。其他所谓“必须配 GOPATH”“手动改 PATH”在现代 Go（1.16+）里基本是过时操作，硬搞反而容易出错。
go version 命令报错或提示“不是内部或外部命令”
这是 PATH 没生效的典型表现，不是 Go 没装好，而是终端没读到新环境变量。
- Windows 用户安装 .msi 后，必须重启终端（CMD/PowerShell/VS Code 内置终端），否则 PATH 不更新
- 别在已打开的 VS Code 里直接 reload window——它不会重载系统级 PATH，得关掉再开
- 验证方式：新开一个 PowerShell，执行
echo $env:PATH，确认输出里包含类似C:\Program Files\Go\bin的路径 - 如果手动添加过 PATH，检查路径末尾有没有多余空格或中文字符（比如复制粘贴时带了全角空格）
go mod init 失败：no modules found or no go files
这不是权限或网络问题，而是当前目录结构不满足 Go Modules 初始化前提。
-
go mod init要求目录下至少有一个.go文件，或位于非空子目录中；空目录直接运行会报这个错 - 常见误操作：先
go mod init，再写main.go—— 正确顺序是先建main.go（哪怕只写package main），再 init - 模块名建议用实际路径（如
github.com/yourname/project），不用example.com这类占位符，否则后续go get可能解析失败 - 如果项目已有
go.mod但想重建，先删掉它再重试，别用go mod init覆盖已有文件
VS Code 中无法跳转定义、无自动补全
大概率是 gopls 没起来，而不是插件没装全。
- 确保已安装官方
Go扩展（作者是golang.go），不是第三方“Go for Visual Studio Code”等旧插件 - VS Code 设置里搜
go.goplsArgs，清空该字段——现代 gopls 不需要手动传参，填了反而启动失败 - 打开命令面板（Ctrl+Shift+P），运行
Go: Install/Update Tools，勾选gopls和dlv，点击 OK；等待下载完成（国内务必已配GOPROXY） - 如果仍卡在 “Loading…”，在 VS Code 终端执行
gopls version，若报错说明二进制损坏，删掉%USERPROFILE%\go\bin\gopls.exe后重装
go run 报错：cannot find module providing package …
本质是 Go 模块感知失效，和 GOPATH 无关，和当前工作目录有关。
- 必须在
go.mod所在目录（或其子目录）下执行go run，跨目录运行会找不到模块根 - 不要在
src目录下建项目——那是 GOPATH 时代的习惯，现在go mod允许任意路径，src反而会干扰模块解析 - 如果项目依赖私有仓库，确认
git config --global url."https://your-git.com".insteadOf "git@your-git.com:"已设置，否则go get会卡在 SSH 认证 -
go list -m all可快速列出当前模块所有依赖，用于判断是否真缺失包
真正容易被忽略的是：Go Modules 的启用不靠开关，而靠是否存在 go.mod。哪怕你删了它，go 命令也会降级回 GOPATH 模式——这种隐式切换会让错误信息变得极其不直观。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
