Go扩展安装后无自动补全，根本原因是gopls语言服务器未正确安装或配置：需手动安装gopls、确保项目含go.mod、工作区路径规范（英文无空格）、禁用干扰插件，并查看gopls日志定位问题。
Go扩展安装后为什么没有自动补全？
VSCode 默认不自带 Go 语言支持，装了 Go 扩展（由 Go Team 官方维护）只是第一步。真正驱动补全、跳转、格式化等功能的是 Go 工具链里的 gopls——它是一个语言服务器（LSP），必须独立运行并被 VSCode 正确识别。
常见错误现象：Ctrl+Space 没反应、import 提示为空、结构体字段不补全。
- 确认已安装 Go（运行
go version能输出版本） - 确保
gopls已安装：执行go install golang.org/x/tools/gopls@latest，完成后检查$GOPATH/bin/gopls或go env GOPATH对应路径下是否存在可执行文件 - VSCode 设置中禁用其他干扰插件（如旧版
Go Nightly或第三方 LSP 封装器） - 打开一个真实存在的
.go文件（不是空文件或未保存的 untitled 文件），gopls才会启动
go.mod 缺失导致补全失效或报错“no packages found”
VSCode 的 Go 扩展默认以模块（module）方式工作。gopls 需要 go.mod 文件来确定项目根目录、依赖范围和 SDK 版本。没有它，补全可能只对标准库生效，第三方包和当前项目代码基本不识别。
使用场景：新建项目、克隆他人仓库但忘记初始化模块、从 src/ 目录直接打开子目录。
立即学习“go语言免费学习笔记（深入）”；
- 在项目根目录运行
go mod init example.com/myapp（模块名可任意，只要合法） - 如果已有依赖，再运行
go mod tidy拉取并写入go.mod - VSCode 可能需要重启或点击右下角提示的
Reload Window - 若项目是 vendor 模式，需设置
"go.useLanguageServer": true并确保go env -w GOFLAGS="-mod=vendor"（不推荐，优先用模块）
补全卡顿、高 CPU 占用或频繁崩溃
gopls 在大型项目或 GOPATH 模式遗留项目中容易因索引过多而响应迟缓，甚至触发 VSCode 的进程自动重启机制，表现为补全延迟、悬浮文档消失、状态栏显示 “Loading…” 长时间不结束。
- 检查是否误将整个
$GOPATH/src目录作为 VSCode 工作区打开（应只打开单个 module 目录） - 在 VSCode 设置中添加限制：
"gopls": {"build.experimentalWorkspaceModule": true}（v0.13+ 推荐） - 关闭不必要的分析项，例如禁用测试覆盖率索引：
"gopls": {"analyses": {"composites": false, "shadow": false}} - 避免在
vendor/目录内编辑——gopls会尝试索引所有 vendored 代码，极易超载
Windows 下中文路径或空格导致 gopls 启动失败
某些版本的 gopls（尤其 v0.12.x 之前）无法正确解析含空格或非 ASCII 字符（如中文）的工作区路径，启动日志里会出现类似 failed to load view for ...: no packages found 或直接静默退出。
- 把项目移到纯英文、无空格路径下（如
C:\dev\mygo），这是最稳妥解法 - 升级到
goplsv0.14+，已修复大部分路径编码问题 - 临时绕过：在 VSCode 设置中指定
gopls启动参数，加--logfile查看真实错误（路径需用双引号包裹） - 不要用 OneDrive 或 WSL 挂载路径作为工作区根——文件系统延迟会导致
gopls初始化超时
gopls 是否成功加载当前模块的完整依赖图。很多看似配置的问题，其实是模块边界没划清、路径不规范或工具版本不匹配。调试时优先看 VSCode 输出面板里的 Go 和 gopls 日志，比反复重装扩展有用得多。 
