重启终端后Go提示找不到已下载包的问题及解决方法

问题根源 #

你遇到的是Go模块模式与GOPATH模式冲突导致的依赖查找失败：

• 代码中导入的github.com/labstack/echo/v4是Go模块版本化的导入路径（v4及以上版本的Echo采用语义化版本规范，导入路径需带/v4后缀）
• Go模块模式下，依赖包会被下载到GOPATH/pkg/mod目录，而非GOPATH/src；但当Go切换回GOPATH模式时，会直接去GOPATH/src下查找带/v4的子目录，而你本地只有未带版本后缀的echo目录，因此报错。

第一次运行成功是因为Go 1.13+默认支持临时模块模式：在无go.mod文件的目录下执行go run时，会自动启用模块模式下载依赖到pkg/mod；但重启终端后，临时模块状态丢失，Go切换回GOPATH模式，导致依赖查找失败。

解决步骤 #

1. 初始化Go模块
   在项目根目录执行命令，生成go.mod文件（模块名可自定义，比如你的项目标识）：

   go mod init test-echo-app
   

2. 整理并下载依赖
   执行命令让Go自动处理依赖，生成go.sum并下载所需的Echo v4版本：

   go mod tidy
   

3. 重新运行程序
   再次执行go run main.go即可正常启动服务。

补充说明 #

• 不要手动在GOPATH/src下创建/v4子目录，Go模块模式会自动管理依赖版本与存储路径
• 后续开发建议始终使用Go模块模式（通过go.mod管理项目），避免GOPATH模式的路径限制

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