补全开关没开或gopls未就位是主因：需在goland中启用autopopup code completion、配置gopls绝对路径并确保项目含go.mod；ctrl+space无反应时，优先检查这两项。
补全开关没开，Ctrl+Space 按了也没反应
GoLand 默认开启输入时自动弹出补全建议，但这个行为可能被关掉或被其他设置压制。先确认最基础的开关：打开 Settings（Ctrl+Alt+S）→ Editor → General → Code Completion，确保勾选了 Autopopup code completion 和 Show the code completion popup automatically when typing。
如果只在按 Ctrl+Space 时才想触发，那可以关掉自动弹出，但必须保留 Basic code completion 启用——否则连 fmt. 这种最简单的补全都不会出来。
- 别误关
Enable smart type completion：它负责过滤出当前上下文真正能用的类型，比如你写strings.Builder{}后输入.，它会优先列出Write、String而不是一堆无关方法 -
Case sensitive completion建议设为Never：Go 标识符大小写敏感，但补全时大小写不匹配容易漏候选，设为Never更实用 - 如果用了非英文键盘（比如中文输入法），补全弹窗可能被输入法遮挡或延迟，临时切英文再试
gopls 没就位，补全只剩 fmt os 这几个包
GoLand 的 Go 补全严重依赖 gopls。没有它，IDE 只能靠语法扫描猜，连你自己写的包都识别不了。不是插件装没装的问题，是语言服务器根本没跑起来。
验证方式：终端执行 gopls version。如果报 command not found，说明没装或没进 PATH。
- 装：运行
go install golang.org/x/tools/gopls@latest（go get已弃用，别用） - 查路径：
which gopls（macOS/Linux）或where gopls（Windows） - 填进 GoLand：
Settings→Tools→Go→Go Language Server→ 把输出的绝对路径粘进去，比如/Users/you/go/bin/gopls - 重启 GoLand —— 不是重启项目，是整个 IDE，否则新路径不生效
补全有但不准，比如 http.NewRequest 不出现，或参数提示乱码
这通常不是补全引擎问题，而是模块环境没对齐。GoLand 的 gopls 在非模块模式下会退化成“标准库模式”，自己写的包、第三方依赖统统不索引。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
检查项目根目录有没有 go.mod。没有就立刻补：
- 终端进项目根目录，运行
go mod init example.com/myapp（模块名合法就行，不用真注册） - 已有依赖？补完
go.mod后再跑go mod tidy，生成完整依赖树 - GoLand 必须以这个含
go.mod的目录为项目根打开 —— 不能只双击某个.go文件，也不能打开它的子文件夹 - 如果项目还在用
vendor/，补全质量会下降；实在要用，得在 GoLand 的Go设置里加环境变量GOFLAGS="-mod=vendor"
Ctrl+Shift+Space 类型匹配补全不生效
这个快捷键调用的是“智能类型匹配补全”，不是基础补全。它需要上下文明确——比如你声明了一个变量 var b bytes.Buffer，然后输入 b. 再按 Ctrl+Shift+Space，才会精准列出 bytes.Buffer 支持的方法。
常见失效原因：
- 光标没停在点号（
.）后面，或者前面变量类型推导失败（比如没初始化、类型断言失败） - 没启用
Smart type completion：在Code Completion设置页确认勾选 - 补全列表太长被截断？调整
Autopopup delay (ms)到 200–500，避免弹窗一闪而过 - 某些泛型场景下
gopls推导不准，这是已知限制，不是配置问题
补全最脆弱的环节永远是环境链：go.mod → gopls → IDE 路径配置 → 编辑器开关。任一环断掉，补全就降级。别跳步排查，从 go mod init 开始重走一遍最稳。
