Vanity Import URL 是 Go 支持的自定义导入路径机制，如 mycompany.com/pkg/utils，它通过 HTTP 响应中的 go-import meta 标签将导入路径映射到真实代码仓库地址，区别于直接使用 github.com/user/repo 的普通 import。
什么是 Vanity Import URL，它和普通 import 有什么区别
Go 的 import 路径默认指向代码托管地址（比如 github.com/user/repo），而 Vanity Import URL 是你自定义的、看起来像域名的导入路径，例如 mycompany.com/pkg/utils。它不直接对应 Git 地址，而是靠一个 HTTP 服务返回特定 HTML 元标签，告诉 go get 真正该去哪拉代码。
关键区别在于：用户写 import "mycompany.com/pkg/utils"，但 Go 工具链会先 GET https://mycompany.com/pkg/utils?go-get=1，再从响应里提取 <meta name="go-import" content="mycompany.com/pkg/utils git https://github.com/mycompany/utils">，最后按这个 git 地址执行克隆。
这不是 DNS 或代理，也不是 GOPROXY 的替代；它是 Go 官方支持的、由服务端控制的重定向机制。
怎么让 go get 正确解析你的 Vanity 导入路径
必须满足三个硬性条件，缺一不可：
立即学习“go语言免费学习笔记（深入）”；
- 你的域名（如
mycompany.com）要能被公网访问，且go get请求时不能返回 301/302 重定向（否则元标签会被忽略） - HTTP 响应状态码必须是 200，Content-Type 必须是
text/html（哪怕只有一行） - HTML 中必须包含且仅包含一个
<meta name="go-import" ...>标签，且content属性格式为：<import-prefix> <vcs> <repo-root>，其中vcs只能是git、hg、svn或bzr
常见错误现象：go get mycompany.com/pkg/utils 报错 unrecognized import path "mycompany.com/pkg/utils": parse https://mycompany.com/pkg/utils?go-get=1: no go-import meta tags，基本就是上面三条中某条没达标。
示例响应（Nginx 静态文件或简单 HTTP 服务均可）：
<!DOCTYPE html> <html> <head> <meta name="go-import" content="mycompany.com/pkg/utils git https://github.com/mycompany/utils"> </head> </html>
为什么 go mod tidy 有时不触发 Vanity 解析
go mod tidy 默认不会重新 fetch 已缓存的模块，即使你改了 vanity 服务的元标签。它只检查本地 go.sum 和 go.mod 中记录的版本是否可达。
真正触发 vanity 解析的典型场景是：
- 首次
go get mycompany.com/pkg/utils@latest - 手动删掉
$GOPATH/pkg/mod/cache/download/mycompany.com目录后再次go get - 用
-u升级依赖，且目标模块在go.mod中尚未声明
注意：如果模块已存在于 go.mod，且你只是改了 vanity 服务的后端 Git 地址，go mod tidy 不会自动切换——它认的是 go.sum 里的校验和，不是导入路径本身。
HTTPS、子路径和通配符的兼容性限制
Vanity URL 不支持通配符（比如 mycompany.com/* 不会自动匹配所有子路径），每个子路径都要单独配置响应。这意味着 mycompany.com/pkg/utils 和 mycompany.com/pkg/http 必须各自返回对应的 <meta> 标签。
HTTPS 是强制要求：Go 1.13+ 默认禁用 HTTP 的 vanity 导入（除非加 -insecure，但生产环境绝不要用）。证书必须有效，不能是自签名或过期。
子路径层级没有限制，但要注意：如果用户 import mycompany.com/pkg，你的服务必须能响应 https://mycompany.com/pkg?go-get=1，而不是只响应根路径 /。Nginx 配置常犯的错是只对 / 返回 meta，导致深层路径 404。
最容易被忽略的一点：Go 工具链会把导入路径中的 v1、v2 版本后缀也当作路径一部分参与请求。比如 mycompany.com/pkg/utils/v2，会请求 https://mycompany.com/pkg/utils/v2?go-get=1 —— 你得确保这个路径也能返回正确的 <meta>，而不是 404 或跳转到 /v2。
