VSCode Go 插件中如何禁用导入语句的文档链接跳转

在 Go 语言开发过程中，许多开发者使用 VSCode 作为主要开发工具，并配合官方的 Go 插件来提高开发效率。然而，一些用户可能会遇到一个令人困扰的问题：当按住 Ctrl 键并点击导入语句时，VSCode 会自动跳转到浏览器打开该包的在线文档，而不是跳转到本地源代码。

问题背景

这个功能原本是通过 go.languageServerExperimentalFeatures 设置中的 documentLink 选项来控制的。但随着 Go 插件和 gopls 的更新，这个设置已经被移除，导致一些用户无法再通过旧方法禁用这个行为。

解决方案

目前，可以通过以下 gopls 设置来改变这一行为：

"gopls": {
   "ui.navigation.importShortcut": "Definition"
}

这个设置会：

1. 禁用导入语句跳转到在线文档的功能
2. 使 Ctrl+点击导入语句时执行"转到定义"操作
3. 从悬停提示中移除"Follow link"选项

注意事项

需要注意的是，当使用这个设置时：

• 如果一个包包含多个文件，gopls 会返回所有文件作为定义位置
• VSCode 会显示一个包含所有可能位置的弹出窗口，而不是直接打开其中一个文件

其他相关设置

虽然以下设置看起来可能相关，但它们实际上并不能完全解决问题：

1. ui.documentation.linksInHover：这个设置只控制悬停提示中的文档链接，不影响 Ctrl+点击行为
2. ui.documentation.linkTarget：尝试禁用链接时会产生错误的链接
3. ui.navigation.importShortcut：设置为"Definition"时虽然移除了在线文档链接，但可能带来多文件选择的复杂性

总结

对于希望禁用导入语句跳转到在线文档功能的开发者，目前的最佳解决方案是使用 ui.navigation.importShortcut 设置。虽然这可能会带来一些多文件选择的复杂性，但它确实提供了直接跳转到源代码的能力，更符合许多开发者的工作习惯。

随着 Go 插件和 gopls 的持续发展，未来可能会有更精细的控制选项出现。开发者可以关注官方更新日志以获取最新信息。