Go 官方 x/ 子模块迁移指南：源码位置、导入路径与使用注意事项

go 官方维护的 golang.org/x/ 系列扩展包（如 x/net、x/crypto）已全部迁移至 github 仓库，源码托管于 github.com/golang/ 组织下，但导入路径保持不变，开发者无需修改 import 语句。

go 官方维护的 `golang.org/x/` 系列扩展包（如 `x/net`、`x/crypto`）已全部迁移至 github 仓库，源码托管于 `github.com/golang/` 组织下，但导入路径保持不变，开发者无需修改 import 语句。

Go 语言自早期起便通过 golang.org/x/ 命名空间提供一系列实验性、非核心但广泛使用的标准库补充包，例如 golang.org/x/net/websocket、golang.org/x/tools、golang.org/x/sync 等。需要明确的是：这些包的导入路径（import path）从未变更——你依然应使用 import “golang.org/x/net/websocket”，而非 github.com/golang/net/websocket。

真正的变化在于源代码托管位置与开发协作方式。自 Go 项目整体迁移到 GitHub 后，所有 x/ 子模块的源码均已移至 github.com/golang 组织下对应仓库：

• golang.org/x/net → github.com/golang/net
• golang.org/x/crypto → github.com/golang/crypto
• golang.org/x/text → github.com/golang/text
• golang.org/x/tools → github.com/golang/tools

以 websocket 包为例，其当前源码位于：

https://www.php.cn/link/ad52498830facdfb560d81b5620b66ae/net/tree/master/websocket

⚠️ 注意事项：

• 不要手动替换 import 路径：github.com/golang/net/websocket 是无效路径，Go 工具链不识别；必须坚持使用 golang.org/x/net/websocket。
• go get 仍可正常工作：go get golang.org/x/net/websocket 会自动解析并从 GitHub 拉取代码（Go 1.13+ 默认启用 proxy.golang.org，亦支持直接 fetch）。
• 部分旧包（如 golang.org/x/net/websocket）已被标记为废弃（deprecated），官方推荐使用更现代的替代方案，例如 golang.org/x/net/websocket 已被 nhooyr.io/websocket（社区主流）或标准库 net/http 结合自定义协议实现取代。查阅各仓库 README 或 pkg.go.dev 页面顶部警告提示即可确认状态。

✅ 正确实践示例：

package main  import (     "log"     "golang.org/x/net/websocket" // ✅ 正确导入路径（即使源在 GitHub） )  func main() {     // 使用逻辑... }

总结：golang.org/x/ 不是“消失”或“重定向到 godoc.org”，而是源码托管平台迁移；godoc.org（现为 pkg.go.dev）仅是文档与模块浏览服务，并非代码仓库。开发者应关注各 x/ 仓库的 README 和 deprecation 声明，及时升级到活跃维护的替代方案，同时保持导入路径的稳定性与兼容性。