go不支持相对路径导入（如"./package1"），必须使用基于模块或gopath的完整逻辑路径；当项目名变更时，需同步更新go.mod中的module声明、所有import语句及硬编码路径，而非仅重命名目录。
go不支持相对路径导入（如"./package1"），必须使用基于模块或gopath的完整逻辑路径；当项目名变更时，需同步更新go.mod中的module声明、所有import语句及硬编码路径，而非仅重命名目录。
在Go语言中，import "./package1" 这类相对路径写法自Go 1.0起即被明确禁止用于生产代码，仅允许在极少数调试场景下配合 go run 单文件执行（如 go run main.go）临时使用。你遇到的错误：
can't load package: local import "../package" in non-local package
正是Go构建工具链对相对导入的主动拦截——它并非bug，而是设计使然：Go坚持“导入路径即唯一标识符”（import path as identity）原则，要求所有包引用必须是全局可解析、可复现、可共享的逻辑路径，而非依赖当前工作目录的脆弱物理路径。
✅ 正确的导入方式：基于模块路径的绝对引用
假设你的项目位于 $GOPATH/src/project1/，且采用传统GOPATH工作流（Go 1.6时期典型场景），则应统一使用以项目根为起点的完整子路径：
// main.go
import (
"project1/package1"
"project1/package2"
"project1/package3"
)
⚠️ 注意：此处 "project1" 并非文件夹名本身，而是 $GOPATH/src/ 下的一级目录名，它构成了该模块的逻辑根路径（相当于隐式 module）。Go会自动将 project1/package1 映射到 $GOPATH/src/project1/package1/ 目录。
? 关键认知：Go的import路径 = $GOPATH/src/ + 路径字符串，与当前.go文件位置无关。
? 面向未来的项目重命名策略（推荐模块模式）
你关心的“项目名变更后是否需批量修改import”问题，答案是：必须修改，但可通过工程化手段最小化影响。
场景：project1 → project1v2
| 位置 | 修改项 | 说明 |
|---|---|---|
| 文件系统 | mv project1 project1v2 | 仅改变本地目录名，不影响构建（因import不依赖物理路径） |
| go.mod | module github.com/yourname/project1v2 | 若已启用模块（Go 1.11+），此行决定所有import前缀 |
| 所有.go文件 | 将 import "project1/xxx" → import "github.com/yourname/project1v2/xxx" | 全局搜索替换，不可遗漏 |
| 硬编码字符串 | 日志、配置、CLI help、测试用例中的路径字符串 | 如 log.Printf("loading %s", "project1/config") 同样需更新 |
✅ 最佳实践建议：
- 立即迁移到Go Modules：运行 go mod init github.com/yourname/project1 初始化模块，从此告别GOPATH路径耦合；
- 使用语义化远程路径：即使本地开发，也建议设为 github.com/yourname/project1（无需真实托管），便于未来开源或协作；
- 自动化检查：重命名后执行 go list -f '{{.ImportPath}}' ./... 验证所有包路径是否一致；
- CI/CD防护：在流水线中加入 go build ./... && go test ./...，确保重命名后无隐藏编译/测试失败。
❌ 常见误区澄清
- “相对路径更灵活？” → 错。相对路径破坏可重现性，无法被go get、CI环境或他人机器正确解析；
- “改目录名就够了？” → 错。仅改文件夹名会导致 go build 报 cannot find package "project1/xxx"，因import路径未同步；
- “可以用包别名规避？” → 不可行。import p1 "project1/package1" 仍需先解决 project1/package1 路径有效性问题。
? 终极建议：从源头规避命名冲突与维护成本
-
main包可执行文件命名：若多个项目生成同名二进制（如import），请始终使用 -o 指定输出路径：
go install -o $GOPATH/bin/project1-import github.com/yourname/project1/cmd/importer
- 子包目录名即导入名：utils/ 目录下必须写 package utils，保持一致性降低认知负担；
- 拒绝package_Golang等非法包名：包名只能是小写字母+数字+下划线，且首字符不能为数字。
Go哲学强调“显式优于隐式”——路径必须明确、命名必须唯一、变更必须可控。拥抱模块化路径体系，既是解决当前问题的钥匙，更是构建可演进Go工程的基石。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
