VSCode需手动配置Go工具链和插件；必须正确安装Go、gopls及dlv等工具，确保GOBIN和PATH设置正确，通过终端启动code .，启用go.formatTool为goimports，运行go mod init初始化模块，并保持go.useLanguageServer开启。
VSCode 本身不自带 Go 支持，必须手动配置工具链和插件；没装对 gopls 或路径没加进 $PATH，编辑器会直接报“Go language server is not available”或无法跳转定义。
确认 Go 已正确安装并可被 VSCode 识别
VSCode 的 Go 插件依赖系统级 Go 安装，不是仅靠插件就能启动开发。先在终端运行 go version 和 which go，确保输出正常；若提示 command not found，说明 Go 二进制未加入 $PATH（macOS/Linux 检查 ~/.zshrc 或 ~/.bash_profile，Windows 检查系统环境变量）。
-
GOROOT一般无需手动设（除非自定义安装路径），但GOBIN建议显式设为$HOME/go/bin，避免工具安装到非预期位置 - VSCode 启动方式影响环境变量读取：从终端执行
code .打开项目，比双击图标更可靠，否则可能读不到 shell 配置里的$PATH - 在 VSCode 设置中搜
go.goroot，留空即可自动探测；若填错路径，gopls启动会失败且无明确报错
安装 go extension 和 gopls（不是 go install github.com/golang/tools/gopls）
VSCode 的官方 Go 插件（golang.go）已内置 gopls 自动下载逻辑，但默认行为是“首次打开 .go 文件时尝试下载”，容易卡住或失败。应手动触发安装：
Cnb Cool Git
下载
CNB 云原生构建平台的 Git 操作技能，支持代码克隆、提交、推送、分支管理、Merge Request 管理、流水线触发与结果读取。初次使用需收集用户的 Git 用户名和邮箱。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入并运行Go: Install/Update Tools - 勾选全部工具，尤其确保
gopls、dlv（调试）、goimports（格式化）被选中 - 如果提示
failed to install gopls: cannot find package，大概率是 GOPROXY 未设或网络问题；临时执行export GOPROXY=https://goproxy.cn,direct再重试 - 安装完成后，检查
$GOBIN/gopls是否存在且可执行；VSCode 设置里go.goplsPath一般不用改，除非用自建版本
关键设置项：格式化、模块初始化与调试准备
默认设置下，保存时不会自动格式化，go mod init 不会自动触发，断点也常因 dlv 权限或配置缺失而无效。
立即学习“go语言免费学习笔记（深入）”；
- 启用保存即格式化：在设置中开启
editor.formatOnSave，并确保go.formatTool设为goimports（不是gofmt） - 新项目务必先在终端运行
go mod init example.com/foo，否则 VSCode 无法加载依赖、跳转失效、gopls日志满屏报 “no module found” - 调试前确认已安装
dlv（在上一步的工具安装列表里勾选），且项目根目录有main.go；断点不生效常见原因是没在 launch.json 里指定"mode": "auto"或"program"路径错误 - 禁用
go.useLanguageServer是最常见误操作——关掉它等于退回到 2018 年的体验：无类型提示、无实时错误、无接口实现导航
真正卡住人的往往不是“怎么装”，而是 gopls 启动日志里那一行被折叠的 failed to load view for ...: no packages matched，它实际意味着模块未初始化或 go.work 配置冲突；这类问题不会弹红框，只会让整个语言功能静默失效。
