go mod download 将依赖写入 .git 或 .vscode 目录，是因为 go.mod 中 module 路径非法（如以 .git 开头），导致 Go 工具链误将其解析为相对路径并降级写入；需修正 module 声明、手动清理错误目录、运行 go clean -modcache 并确保无父级 go.mod 干扰。
为什么 go mod download 会把依赖写进 .git 或 .vscode 目录？
这不是 Go 工具链的默认行为，而是项目根目录下存在同名隐藏目录（如 .git）且被误设为模块路径前缀时触发的副作用。典型诱因是执行过 go mod init 时当前路径含隐藏文件夹名，或手动编辑了 go.mod 中的 module 路径为类似 .git/myproject 这种非法格式 —— Go 会尝试解析该路径为本地相对路径，进而把依赖缓存“降级”写入该目录下的 pkg 子目录。
检查并修正 go.mod 中的 module 声明
打开 go.mod 文件，确认首行 module 后的路径是否合法：
- 不能以
.、..或.开头的路径段（如.git、.config） - 不能包含操作系统保留名（Windows 下的
CON、AUX等） - 推荐使用纯小写字母 + 连字符 + 数字的域名风格，例如
example.com/myapp
如果发现 module .git/mylib 这类声明，立即改为合理值，再运行 go mod tidy —— 它会重新解析依赖图并清空错误路径下的残留缓存。
清理错误拉取产生的残留文件
Go 不会自动删除写错位置的依赖包，需手动干预：
立即学习“go语言免费学习笔记（深入）”；
- 检查
$(go env GOPATH)/pkg/mod/cache/download/是否有异常子目录（如含.git字样） - 搜索项目根目录及所有父级路径中是否存在
pkg/或mod/子目录（尤其在.git/、.idea/下） - 直接删除这些非法位置的
pkg和mod文件夹 - 运行
go clean -modcache彻底清空全局模块缓存
之后再执行 go mod download，依赖将严格写入 $(go env GOPATH)/pkg/mod/ 下的标准结构中。
避免 IDE 或脚本自动创建非法 module 路径
VS Code 的 Go 扩展、JetBrains 系列 IDE 或某些 CI 脚本在初始化模块时可能基于当前文件夹名生成 module 名，若工作目录是 /tmp/.myproj，就容易产出 module .myproj。预防方式：
- 初始化前先用
pwd确认所在路径不含隐藏文件夹名 - 显式指定 module 名：
go mod init example.com/myapp，不依赖自动推导 - 在
.gitignore中加入**/pkg/和**/mod/，防止误提交非法缓存目录
最常被忽略的是父目录里残留的 go.mod —— 它会让子目录下的 go 命令误认为处于嵌套模块中，从而扭曲路径解析逻辑。务必逐级检查 cd .. && ls go.mod。
