go.mod中require行不自动更新是因Neovim不解析该文件，仅依赖gopls加载模块图；需用go get触发写入与下载，再经go mod tidy同步，否则gopls无法识别新依赖。
go.mod 文件里 require 行不自动更新？别手改
Neovim 本身不解析或生成 go.mod 的 require 行，它只靠 gopls 提供语义支持。你看到的“依赖提示”（比如 hover 显示某个包版本、跳转到依赖源码、补全时列出已导入包）全依赖 gopls 是否正确加载了模块图。
常见错误是：手动在 go.mod 里加了一行 require github.com/xxx/yyy v1.2.3，但没运行 go mod download 或 go get，结果 gopls 启动后根本读不到这个模块——提示里自然不出现。
- 真正触发
require写入和模块下载的，只有go get命令（如go get github.com/valyala/fastjson@v1.17.0） -
gopls启动时会调用go list -m all构建模块图，如果某依赖没被下载或校验失败，它就直接忽略那一行 - 确保项目根目录有
go.mod，且当前 buffer 是*.go文件，否则gopls可能 fallback 到 GOPATH 模式，依赖提示失效
gopls 报 “no module found” 或依赖不提示？检查这三个点
这是最常卡住的地方：Neovim 能调起 gopls，但提示里看不到本地或第三方依赖，hover 也空白。
-
gopls版本太旧或不匹配 Go 版本：运行gopls version，确认输出中 Go version ≥ 当前项目所用 Go（例如项目用 Go 1.22，gopls编译自 Go 1.20 就可能漏解析新语法） - 项目没启用模块模式：在项目根目录运行
go mod graph | head -n5，如果报错或无输出，说明go.mod没生效，先执行go mod init your.module.name -
gopls配置没开semanticTokens：在lspconfig.gopls.setup{}里必须显式启用，否则类型、包路径等高亮和提示会降级——加上capabilities = require('cmp_nvim_lsp').default_capabilities()并确保gopls启动参数含-rpc.trace便于排查
补全里看不到未导入的包？不是 bug，是 gopls 的默认策略
输入 http. 后，nvim-cmp 默认只补全已 import 的包成员，不会主动列出所有 net/http 导出符号——除非你提前 import 了。
立即学习“go语言免费学习笔记（深入）”；
想让未导入包也进补全列表，得靠 gopls 的 completion 设置：
- 在
lspconfig.gopls.setup{}的settings字段里加：["gopls", { "completeUnimported": true }] - 注意：开启后补全项变多，首次响应略慢；且仅对标准库和已下载的模块生效，
go get没拉过的包仍不会出现 - 如果你用
go.nvim，它默认已设complete.use_lsp = true，但需确认go.nvim的opts.lsp_cfg为true，否则不会透传该配置给gopls
require 行版本号写错导致提示错乱？优先看 go.sum 和实际加载路径
你改了 go.mod 里的 require 版本，但 hover 显示的还是旧版函数签名，甚至跳转到错误 commit —— 这通常不是 Neovim 或插件的问题，而是 Go 模块解析的实际路径和你写的不一致。
关键检查点：
- 运行
go list -m -f '{{.Dir}}' github.com/sirupsen/logrus，看输出路径是否指向$GOPATH/pkg/mod/...下的真实解压目录；如果不是，说明replace或exclude生效了，但你没意识到 -
go.sum里对应模块的 hash 是否匹配你期望的版本？不匹配意味着go mod verify会失败，gopls可能 fallback 到缓存或忽略该模块 -
gopls日志里搜failed to load package或module not found，它会明确告诉你哪一行require被跳过了
模块依赖提示不是静态文本，它每秒都在重新计算模块图。任何对 go.mod 的修改，都必须经过 Go 工具链落地，gopls 才会感知到——Neovim 只是管道，不是决策者。
