用途：在 Go 代码库中做语义化导航与分析，用工具链理解类型含义，而非依赖文本搜索。方法名会在多个类型间重复、接口隐式实现、点导入会误导 grep，因此改动共享代码前应先用能理解类型的工具确认真实情况。
主要能力与用法： 定位与查询符号：gopls references file.go:LINE:COL 查引用，gopls definition 查定义，gopls implementation 查接口实现或类型满足的接口，gopls call_hierarchy 查传递调用者，gopls workspace_symbol 按名查找，gopls symbols 列出单文件符号。位置格式为 file.go:line:column（从 1 开始）。 查看 API：go doc ./internal/service、go doc pkg Symbol、go doc -all 查看包概览、单个符号与完整导出接口。 依赖分析：go list ./...、go list -deps、go list -json 查看包列表、依赖边与机器可读输出，用于验证分层假设。 语义重命名：gopls rename -w file.go:LINE:COL NewName，会同步更新接口、嵌入与测试包中的引用，禁止用查找替换改标识符。 无编辑器诊断：gopls check ./internal/... 与 go vet ./...。
适用场景：修改函数前枚举调用点、映射接口实现、理解依赖图、探索陌生 API、安全重命名、代码审查时做诊断。
限制：所有 gopls 命令需在模块内运行且构建缓存已预热，先执行一次 go build ./...；gopls 需要可类型检查的包，代码无法编译时应改用 grep。字符串字面量、注释、TODO、文档以及快速存在性检查仍适合 grep。经验规则：标识符用 gopls，字面量与散文用 grep。
验证清单：改动共享符号前用 gopls references 枚举调用点；改接口前先跑 gopls implementation；重命名只用 gopls rename -w；用 go list 导入数据验证分层；先用 go doc 探索陌生包；无编辑器时运行 gopls check / go vet。