Go语言使用github.com/jamesruan/sodium库的包识别问题求助

问题根源 #

这个库的box.go等文件实际属于sodium/unstable子包，但v1.0.14版本的模块结构在gopls（Go语言服务）下出现识别异常，加上Go 1.23的模块模式与gopls的兼容性细节，导致除sodium.go外的文件被标记为“无对应包”，进而无法识别SecretBox等方法。另外强制使用go.work可能干扰了模块的正常解析逻辑。

可行解决方法 #

1. 正确导入子包 #

SecretBox等方法并不在根包sodium下，而是在sodium/unstable子包中，修改导入语句：

import "github.com/jamesruan/sodium/unstable"

之后用unstable.SecretBox调用相关加密方法，gopls会正确识别子包中的类型和函数。

2. 调整gopls配置 #

在VSCode的settings.json中添加以下配置，关闭实验性模块隔离，帮助gopls正确解析库结构：

"gopls": {
  "build.experimentalModuleIsolation": false
}

配置完成后，按Ctrl+Shift+P调出命令面板，选择Go: Restart Language Server重启服务。

3. 清理模块缓存并重载依赖 #

执行以下命令清理本地模块缓存，重新拉取并整理依赖：

go clean -modcache
go mod tidy

完成后重启VSCode，让gopls重新扫描依赖包。

4. 移除不必要的go.work文件 #

如果你的项目并非多模块工作区，直接删除go.work文件。Go的单模块模式会自动处理依赖解析，避免工作区模式带来的包识别冲突。

内容的提问来源于stack exchange，提问作者Tommi