Go模块缓存创建失败求助：mkdir指向go.exe文件路径错误

根因分析 #

你的核心问题是GOPATH被错误设置为Go可执行文件路径（C:\Program Files\Go\bin\go.exe），而非合法的目录路径。Go的模块缓存目录（GOMODCACHE）默认基于GOPATH生成，导致程序尝试在一个可执行文件路径下创建文件夹，触发路径不存在的错误。

这种错误通常由以下场景导致：

• 系统环境变量配置时，误将GOPATH的值填写为go.exe的路径而非目录
• VS Code的Go插件配置中，手动覆盖了GOPATH的正确值
• 当前终端会话存在临时的环境变量覆盖

分步解决方案 #

1. 修正系统环境变量 #

1. 按下Win + R输入sysdm.cpl打开系统属性，切换到高级标签页，点击环境变量
2. 在用户变量或系统变量中找到GOPATH：
   • 如果存在，双击修改为你原本的目标路径：C:\Users\Cobra\OneDrive\Documents\Go
   • 如果不存在，点击新建，变量名填GOPATH，变量值填上述路径
3. 确认GOROOT变量正确：值为C:\Program Files\Go，且该目录确实存在Go的安装文件
4. 确认Path变量中包含C:\Program Files\Go\bin，确保go命令能全局调用
5. 点击确定保存所有修改，关闭系统属性窗口

2. 清除终端临时环境变量 #

• 关闭所有打开的VS Code窗口和终端窗口，重新打开一个新的终端
• 执行go env命令，检查GOPATH和GOMODCACHE是否恢复正确：
  • 正确的GOPATH应为C:\Users\Cobra\OneDrive\Documents\Go
  • 正确的GOMODCACHE应为C:\Users\Cobra\OneDrive\Documents\Go\pkg\mod

3. 修正VS Code的Go插件配置 #

1. 在VS Code中按下Ctrl + ,打开设置
2. 在搜索框输入go.gopath，检查是否有手动设置的路径：
   • 如果有，点击编辑按钮，将其修改为C:\Users\Cobra\OneDrive\Documents\Go
   • 如果不需要手动设置，直接勾选让Go工具来决定GOPATH选项
3. 同样检查go.goroot，确保值为C:\Program Files\Go或留空让工具自动识别
4. 重启VS Code，打开终端执行go run main.go测试

4. 手动重置模块缓存路径（可选） #

如果上述步骤后GOMODCACHE仍不正确，可以手动设置：
在终端执行：

go env -w GOMODCACHE=C:\Users\Cobra\OneDrive\Documents\Go\pkg\mod

验证方法 #

执行以下命令确认所有配置正确：

go env GOPATH GOROOT GOMODCACHE

输出应分别对应：

• C:\Users\Cobra\OneDrive\Documents\Go
• C:\Program Files\Go
• C:\Users\Cobra\OneDrive\Documents\Go\pkg\mod

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