Go 标准库提供了 go/build.IsLocalImport 函数，可安全、准确地判断一个导入路径是否属于本地路径（如 .、..、./pkg 或 ../lib），避免手动解析带来的错误风险。
go 标准库提供了 `go/build.islocalimport` 函数，可安全、准确地判断一个导入路径是否属于本地路径（如 .、..、./pkg 或 ../lib），避免手动解析带来的错误风险。
在 Go 项目开发中，区分本地导入（relative import）与远程模块导入（如 github.com/user/repo）至关重要——尤其在构建工具、代码分析器或依赖图生成器等场景中。手动通过字符串匹配或路径解析（例如检查是否以 ./ 或 ../ 开头）不仅易出错，还可能遗漏边界情况（如 . 或 .. 单独出现），且不兼容 Go 工具链对本地导入的权威定义。
所幸，Go 标准库已在 go/build 包中内置了经过充分测试的判定逻辑：build.IsLocalImport。该函数严格遵循 Go 编译器和 go 命令对“本地导入路径”的语义定义，返回 true 当且仅当路径为以下形式之一：
- .
- ..
- 以 ./ 开头的路径（如 ./internal/utils）
- 以 ../ 开头的路径（如 ../shared）
✅ 正确用法示例：
package main
import (
"fmt"
"go/build"
)
func main() {
tests := []string{
".", // true
"..", // true
"./handler", // true
"../model", // true
"fmt", // false
"net/http", // false
"github.com/go-sql-driver/mysql", // false
}
for _, path := range tests {
fmt.Printf("%-25s → %t\n", fmt.Sprintf("import %q", path), build.IsLocalImport(path))
}
}
⚠️ 注意事项：
- go/build 包已标记为 deprecated（自 Go 1.16 起），但 IsLocalImport 仍被保留并推荐用于此特定用途；官方文档明确指出其“不会被移除”，因其功能无替代品且高度稳定。
- 该函数仅做语法判断，不验证路径是否存在或是否可导入；它不涉及文件系统访问，纯内存计算，性能优异。
- 不适用于 Go Modules 的 replace 或 indirect 依赖分析——它只回答“这个字符串是否符合 Go 本地导入语法”，而非“这个包是否来自本地磁盘”。
总结：始终优先使用 build.IsLocalImport 判断本地导入路径。它是 Go 官方维护的、经过生产环境验证的权威实现，比任何自定义解析逻辑更可靠、更简洁、更未来兼容。
