Go 语言支持通过 // import "xxx" 注释在包声明后显式声明其期望的导入路径，编译器和 go 工具链会强制校验实际导入路径是否匹配，从而确保模块引用的唯一性与一致性。
Go 语言支持通过 `// import "xxx"` 注释在包声明后显式声明其**期望的导入路径**，编译器和 `go` 工具链会强制校验实际导入路径是否匹配，从而确保模块引用的唯一性与一致性。
在 Go 中，一个包的“官方”导入路径并非仅由其文件系统位置决定，而是由源码中显式的 // import "..." 注释（称为 canonical import path）所定义。当该注释存在时，go build、go test 等命令会在编译前严格检查：若某包被以非声明路径的方式导入（例如从 github.com/yourname/mypkg 导入，但包内声明为 // import "example.com/mypkg"），则构建会立即失败，并提示类似错误：
code in directory /path/to/go/src/github.com/yourname/mypkg expects import "example.com/mypkg"
这正是你在使用 golang.org/x/crypto/bcrypt 时遇到的行为来源——查看其源码（如 bcrypt.go）可见：
// Copyright 2011 The Go Authors. All rights reserved. // Use of this source code is governed by a BSD-style // license that can be found in the LICENSE file. package bcrypt // import "golang.org/x/crypto/bcrypt"
✅ 此处 // import "golang.org/x/crypto/bcrypt" 即为 canonical import path 声明，它告诉 Go 工具链：“此包只能且必须通过 golang.org/x/crypto/bcrypt 被导入”。
如何在自己的包中启用该机制？
只需在 package 声明紧下方（同一行或下一行，无空行隔开）添加格式为 // import "full/import/path" 的注释即可：
package utils // import "mycompany.com/lib/utils"
import "fmt"
func Hello() string {
return "Hello from utils!"
}
⚠️ 注意事项：
- 注释必须紧邻 package 行，中间不能有空行或其它语句；
- 导入路径必须是完整、合法的导入路径（通常为 URL 形式，如 example.com/project/subpkg），不支持相对路径或本地路径；
- 该机制自 Go 1.4 引入（Go 1.4 Release Notes），并在后续版本中成为标准行为；
- 它不影响包的实际存放位置（你仍可将代码放在 ~/go/src/github.com/you/repo），但所有用户必须用声明的路径导入，否则构建失败；
- 对于模块化项目（go.mod），canonical import path 应与模块路径（module 指令）保持逻辑一致，避免混淆；若模块路径为 example.com/mymodule，建议 canonical path 也以此为根。
为什么需要它？
- 防止 Fork 冲突：避免多个 fork（如 github.com/user/repo 和 github.com/other/repo）被不同项目以不同路径导入，导致符号重复或版本混乱；
- 品牌统一与迁移控制：当项目从 github.com/oldorg/pkg 迁移到 example.com/pkg 时，可通过 canonical path 强制新导入路径，同时保留旧仓库兼容性（配合重定向或代理）；
- Go 生态规范性：golang.org/x/ 系列包均采用此机制，确保整个 Go 社区引用一致，是官方推荐的最佳实践。
简言之：// import "path" 不是运行时检测，而是 Go 工具链在解析源码阶段执行的静态路径约束——它是 Go 包设计中保障可维护性与可移植性的关键基础设施之一。
