Go to Definition 失效主因是 gopls 未正常运行、缺少 go.mod 或文件未识别为 Go 语言；应重启 gopls、确认项目根目录含 go.mod、右下角设为 Go 模式，并清理缓存。
Go to Definition（跳转到定义）在 VSCode 中失效，通常不是插件崩溃，而是环境配置、索引状态或项目结构出了问题。重点先检查 Go 扩展是否正常激活、go.mod 是否存在、以及语言服务器（gopls）是否已启动并完成索引。
确认 gopls 正常运行并完成初始化
VSCode 的 Go 支持依赖 gopls（Go Language Server）。如果它没启动、卡住或崩溃，跳转功能就会完全失灵。
- 打开命令面板（Ctrl+Shift+P），输入 Go: Restart Language Server，强制重启 gopls
- 查看右下角状态栏：若有 gopls (initializing...) 长时间不消失，说明索引卡住，可尝试关闭大文件夹或排除 node_modules 等非 Go 目录
- 在 VSCode 设置中搜索 go.goplsArgs，确保没有错误参数（比如误加了 -rpc.trace）；默认留空最稳妥
检查工作区是否识别为 Go 项目
VSCode 必须正确识别当前文件夹为 Go 模块，才能启用完整语义功能。
- 确保项目根目录下存在 go.mod 文件；若没有，终端执行 go mod init your-module-name 初始化
- 不要用子目录直接打开（如只打开
./cmd/myapp），应打开含 go.mod 的顶层目录 - 打开命令面板，运行 Go: Locate Configured Go Tools，确认
gopls路径有效且版本 ≥ 0.14.0
验证文件类型和扩展名是否被正确识别
VSCode 按文件后缀决定使用哪种语言模式。如果 .go 文件被识别成 Plain Text 或其他语言，跳转会直接禁用。
- 右下角查看当前语言模式（如显示 “Plain Text”），点击它，选择 Go
- 执行 Preferences: Configure File Association for '.go'，确保绑定到 Go 语言
- 检查是否有其他插件（如某些语法高亮扩展）干扰了语言检测，可临时禁用非必要 Go 相关插件测试
清理缓存与重载窗口
旧缓存或插件状态异常也可能导致跳转逻辑错乱，尤其在升级 Go 或 gopls 后。
- 执行 Developer: Reload Window（或 Ctrl+Shift+P → 输入 reload）
- 删除 $HOME/.cache/gopls（Linux/macOS）或 %LOCALAPPDATA%\gopls（Windows），清空语言服务器缓存
- 关闭所有 VSCode 窗口，再重新打开项目（避免后台残留进程影响）
基本上就这些。多数情况下，重启 gopls + 确保 go.mod 存在 + 文件类型正确，就能恢复跳转。如果仍无效，可在 VSCode 输出面板中切换到 gopls 标签，看是否有报错日志，针对性排查。
