Go环境需安装go命令、gopls语言服务器及VS Code官方Go扩展；项目必须初始化为模块（go mod init），配置tasks.json才能运行，调试依赖go.mod存在。
确认 Go 环境和 VS Code 扩展已就绪
VS Code 本身不内置 Go 支持，必须依赖 gopls（Go 官方语言服务器）和 Go 扩展协同工作。常见错误是只装了扩展却没装 go 命令或 gopls，导致“无法识别 package main”或“no workspace detected”。
- 终端执行
go version确认 Go 已安装且在$PATH中（建议 1.20+） - 运行
go install golang.org/x/tools/gopls@latest安装语言服务器（生成的二进制默认在$GOPATH/bin/gopls，需确保该路径也在$PATH） - VS Code 中安装官方
Go扩展（作者：Go Team at Google），禁用其他非官方 Go 插件 - 重启 VS Code 后，打开任意
.go文件，底部状态栏应显示gopls正在运行
初始化一个最小可运行的 Go 模块
Go 1.16+ 强制要求模块支持，不能直接在全局 $GOPATH/src 下写代码。空文件夹里直接写 main.go 是无效的——go run 会报 no Go files in current directory，因为找不到模块根。
- 新建空文件夹，cd 进去，执行
go mod init hello（hello是模块名，不必与文件夹同名，但建议一致） - 创建
main.go，内容必须含package main和func main()，例如：
package main
import "fmt"
func main() {
fmt.Println("Hello, VS Code")
}
- 此时目录下会出现
go.mod和（首次运行后）go.sum，这才是合法的 Go 模块根
在 VS Code 中正确运行和调试
直接按 Ctrl+F5 或点右上角 ▶️ 运行按钮，默认会失败——VS Code 不知道该用什么配置运行 Go。它不会自动调用 go run main.go，除非你明确告诉它。
- 按
Ctrl+Shift+P打开命令面板，输入并选择Tasks: Configure Task→Create tasks.json file from template→Others - 替换生成的
.vscode/tasks.json内容为：
{
"version": "2.0.0",
"tasks": [
{
"label": "go run",
"type": "shell",
"command": "go",
"args": ["run", "${file}"],
"group": "build",
"problemMatcher": ["$go"]
}
]
}
- 保存后，按
Ctrl+Shift+B即可运行当前文件；也可用命令面板选Tasks: Run Task→go run - 调试更简单：打开
main.go，点左侧行号旁加断点，按F5，VS Code 会自动生成.vscode/launch.json并启动调试器（前提是项目有go.mod）
常见报错和绕不开的细节
很多问题其实不是配置错，而是忽略了 Go 的工程约束。比如在子目录里写 main.go 却没意识到模块路径要匹配导入路径；或者用了相对路径导入却忘了 go mod tidy。
立即学习“go语言免费学习笔记（深入）”；
-
cannot find package "xxx" in other modules：说明 import 路径和实际模块路径不一致，检查go.mod第一行module xxx和import语句是否匹配 - 终端能
go run main.go成功，但 VS Code 里点运行没反应：大概率是没配置tasks.json，或当前打开的是文件夹的父级（VS Code 未识别到go.mod） -
gopls报no views configured：关闭所有窗口，重新用 VS Code 打开包含go.mod的**文件夹**（不是整个磁盘或父目录） - 修改
go.mod后新包不提示、跳转失效：手动执行go mod tidy，然后在 VS Code 中按Ctrl+Shift+P→Developer: Reload Window
真正卡住人的往往不是“怎么配”，而是没意识到 VS Code 的 Go 支持完全依赖 go mod 的存在和位置——它不是一个独立 IDE，而是一个精准适配 Go 工程约定的编辑器前端。
