1. Go语言的包与导出机制概述
Go语言采用包（package）作为代码组织的基本单位。每个Go源文件都属于一个特定的包，并通过package声明指定。Go语言的可见性规则非常简洁：任何以大写字母开头的函数、变量、类型或方法，都将被视为已导出（exported），可以在其所属包外部被引用。反之，以小写字母开头的标识符则仅在包内部可见。
当一个包被编译时，编译器会处理该包下的所有Go源文件，并将导出的符号（如函数、类型等）记录下来，供其他包在导入时使用。如果一个函数被声明为导出（即首字母大写），但其所在的源文件没有被包含在包的编译过程中，那么在其他包尝试引用该函数时，就会出现“未定义”的错误。
2. 问题现象：未定义的导入函数
考虑以下Go项目结构，其中包含一个grid包和一个main包：
src/grid/node.go
立即学习“go语言免费学习笔记（深入）”；
package grid
type Node struct {
id uint
name string
pos_i uint
pos_j uint
node_type string
}src/grid/grid.go
package grid
type Grid struct {
number_lines uint
number_columns uint
width uint
height uint
nodes []Node
}
// InitGrid是一个导出的函数，用于初始化Grid结构体
func InitGrid() *Grid {
g := new(Grid)
g.number_lines = 4
g.number_columns = 4
g.width = 400
g.height = 400
return g
}src/main/main.go
package main
import (
"fmt"
"grid" // 导入grid包
)
func main() {
// 尝试调用grid包中导出的InitGrid函数
grid_ := grid.InitGrid()
fmt.Println(grid_)
}为了编译这些包，项目使用了传统的gomake工具和Makefile：
src/grid/Makefile (错误配置)
include $(GOROOT)/src/Make.inc
TARG=grid
GOFILES=\
node.go\
# 注意：这里缺少了grid.go
include $(GOROOT)/src/Make.pkgsrc/main/Makefile
include $(GOROOT)/src/Make.inc
TARG=main
GOFILES=\
main.go\
include $(GOROOT)/src/Make.cmd当尝试编译grid包时，一切顺利。然而，当编译main包时，却遇到了以下错误：
manbear@manbearpig:~/Bureau/go_code/main$ gomake 6g -o _go_.6 main.go main.go:15: undefined: grid.InitGrid make: *** [_go_.6] Erreur 1
错误信息清晰地指出grid.InitGrid是“未定义”的。这表明尽管InitGrid函数在grid.go中以大写字母开头（已导出），但main包在导入grid包时，无法找到这个函数。
这本书给出了一份关于python这门优美语言的精要的参考。作者通过一个完整而清晰的入门指引将你带入python的乐园，随后在语法、类型和对象、运算符与表达式、控制流函数与函数编程、类及面向对象编程、模块和包、输入输出、执行环境等多方面给出了详尽的讲解。如果你想加入 python的世界，David M beazley的这本书可不要错过哦。 (封面是最新英文版的,中文版貌似只译到第二版)
3. 根本原因分析：包编译不完整
这个问题的根本原因在于grid包的Makefile配置不完整。在src/grid/Makefile中，GOFILES变量只包含了node.go文件，而定义了InitGrid函数的grid.go文件被遗漏了。
当gomake工具根据Makefile编译grid包时，它只会处理GOFILES中列出的源文件。这意味着grid.go文件中的InitGrid函数并没有被编译到grid包的二进制文件或归档中。因此，当main包尝试导入并使用grid包时，它所能“看到”的grid包版本中，并不包含InitGrid这个函数，从而导致了“undefined”错误。
4. 解决方案：确保包文件完整编译
解决这个问题的方法非常直接：确保grid包的Makefile中，GOFILES变量包含了该包下所有需要编译的Go源文件。
src/grid/Makefile (正确配置)
include $(GOROOT)/src/Make.inc
TARG=grid
GOFILES=\
grid.go\
node.go\ # 确保所有Go源文件都被包含
include $(GOROOT)/src/Make.pkg将grid.go添加到GOFILES列表后，重新编译grid包，然后编译main包，问题即可解决。gomake现在会将grid.go和node.go一起编译到grid包中，使InitGrid函数在包外部可见并可用。
5. 现代Go项目管理：Go Modules的优势
值得注意的是，上述问题和解决方案主要针对使用Go语言早期（Go 1.11之前）的gomake或手动Makefile管理项目的情况。在现代Go开发中（Go 1.11及更高版本），官方推荐使用Go Modules进行依赖管理和项目构建。
使用Go Modules时，开发者通常无需手动编写Makefile来指定GOFILES。go build和go install等命令会自动扫描当前目录及其子目录下的所有Go源文件，并根据包声明自动识别和编译它们。这大大简化了构建过程，并减少了因手动配置错误而导致的问题，如本教程中遇到的“未定义函数”错误。
例如，在Go Modules项目中，只需在项目根目录运行go mod init
6. 总结与最佳实践
“未定义的导入函数”是Go语言中一个常见的编译错误，尤其在使用传统构建方式时。其核心原因在于：
- 导出规则： Go语言中只有以大写字母开头的标识符才能被包外部引用。
- 编译完整性： 确保包的所有相关源文件都被包含在编译过程中。如果使用Makefile，务必检查GOFILES变量是否列出了所有必要的.go文件。
虽然现代Go Modules已极大简化了项目构建，但理解Go语言的包编译原理和导出规则仍然至关重要。这有助于开发者在遇到类似问题时，能够迅速定位并解决。在Go项目中，始终检查函数是否已导出（首字母大写），并确认所有定义了这些函数的源文件都已正确参与到包的编译中，是避免此类错误的最佳实践。
