如何在本地文件系统管理Go包？本地包导入失败求助

核心前提：使用Go模块（无需GOPATH或远程仓库） #

Go 1.11+ 官方推荐用模块管理依赖，完全支持本地包，不需要绑定GitHub等平台。

步骤1：初始化项目模块 #

在你的项目根目录执行：

go mod init <自定义模块名>

比如你的项目叫local-tools，就执行go mod init local-tools——模块名可以是任意自定义名称，不用和远程仓库挂钩。

步骤2：正确组织目录结构 #

举个典型的目录示例：

local-tools/
  go.mod       # 模块配置文件
  main.go      # main包入口文件
  myfuncs/     # 自定义包目录
    helper.go  # 自定义包的代码文件

• 自定义包的代码文件（比如helper.go）里，包声明建议和目录名一致：package myfuncs
• 关键规则：要让main包能访问的函数，必须首字母大写（Go的导出规则），比如func Calculate(x int) int，小写函数属于包内私有，外部无法调用。

步骤3：在main包中导入本地包 #

在main.go里，用「模块名+自定义包子路径」的方式导入：

package main

import (
    "fmt"
    "local-tools/myfuncs" // 模块名+子目录名
)

func main() {
    fmt.Println(myfuncs.Calculate(10))
}

常见错误修正 #

1. 无需提前编译自定义包：Go会在编译main包时自动处理依赖的本地包，单独编译自定义包生成二进制是多余操作。
2. 禁止用./myfuncs或绝对路径导入：模块模式下必须使用模块名+子路径的格式。
3. 检查函数导出状态：如果导入后提示函数不存在，先确认函数首字母是否大写。

跨目录的本地包导入（可选） #

如果你的自定义包不在当前项目根目录下，比如存放在~/go-local-libs/myfuncs，可以通过模块替换来关联：

1. 在当前项目根目录执行：

go mod edit -replace local-tools/myfuncs=~/go-local-libs/myfuncs

2. 执行go mod tidy同步依赖，之后依然用import "local-tools/myfuncs"导入即可。

内容的提问来源于stack exchange，提问作者fjuedes