完整教程：Go 1.25 新特性：正式支持 Git 仓库子目录作为 Go 模块

在 Go 语言的发展历程中，模块（Go Modules）自 Go 1.11 引入以来，已成为官方推荐的依赖管理方式。然而，长期以来 Go 模块有一个令人困扰的限制：模块必须位于 Git 仓库的根目录。这一限制使得在 monorepo（单体仓库）或多语言项目中组织代码变得困难。

好消息是：Go 1.25 版本正式支持将 Go 模块放置在 Git 仓库的子目录中！本文将深入解析这一新特性的背景、原理、使用方式及其对开发者的意义。

---

一、问题背景：为什么需要子目录模块？

许多开源项目或企业内部项目采用 monorepo 架构，即在一个仓库中维护多个子项目（可能包含不同语言、不同服务）。例如：

my-monorepo/
├── go/
│   └── mylib/          ← 希望这里是一个独立的 Go 模块
├── python/
│   └── mypylib/
├── docs/
└── README.md

理想情况下，go/mylib 应该是一个独立的 Go 模块，可通过如下方式引用：

import "github.com/yourname/my-monorepo/go/mylib"

但在 Go 1.25 之前，这是不被支持的。原因在于：

Go 的 go get 命令依赖仓库根目录的 go.mod 文件，并通过 <meta name="go-import"> 标签定位模块根路径。它无法识别子目录中的 go.mod。

尝试执行：

go get github.com/nhooyr/websocket/mod@latest

会失败，因为 Go 工具链认为模块路径必须对应仓库根。

---

二、Go 1.25 的解决方案

Go 团队在 Issue #34055 中正式提出并实现了 子目录模块支持，核心改动如下：

1. 扩展 go-import meta 标签格式

以往的 go-import 标签格