go 包中函数必须首字母大写且定义在包级别（而非作为方法绑定到类型上），才能被其他包导入并调用；否则会出现 “undefined” 编译错误。本文详解导出规则、常见错误及修复方案。
go 包中函数必须首字母大写且定义在包级别（而非作为方法绑定到类型上），才能被其他包导入并调用；否则会出现 “undefined” 编译错误。本文详解导出规则、常见错误及修复方案。
在 Go 语言中，标识符（如函数、变量、类型、结构体字段）能否被外部包访问，完全取决于其首字母是否大写——这是 Go 的导出（exported）机制：只有首字母大写的标识符才是导出的（public），才能被其他包引用；小写字母开头的标识符仅在本包内可见（private）。
你遇到的错误：
./attempt.go:6: undefined: go_nessus.MakeClient
根本原因在于：MakeClient 当前被定义为 Nessus 类型的方法（receiver 方法），而非包级别的导出函数：
func (nessus *Nessus) MakeClient(host, port, accessKey, secretKey string) Nessus { ... }这种写法表示：MakeClient 是 *Nessus 类型的一个实例方法，它必须通过一个 Nessus 实例（或指针）来调用，例如 n.MakeClient(...)。而你在 main 中却试图像调用包函数一样直接使用 go_nessus.MakeClient(...)，Go 编译器自然无法找到该符号——因为它根本不是包的导出成员。
✅ 正确做法是将其改为包级导出函数：
// go-nessus/client/client.go
package go_nessus
import "fmt"
// Nessus 是客户端配置结构体（确保字段也首字母大写才能导出）
type Nessus struct {
Ip string `json:"ip"`
Port string `json:"port"`
AccessKey string `json:"access_key"`
SecretKey string `json:"secret_key"`
}
// ✅ 正确：首字母大写 + 无 receiver → 导出的包级函数
func MakeClient(host, port, accessKey, secretKey string) *Nessus {
return &Nessus{
Ip: host,
Port: port,
AccessKey: accessKey,
SecretKey: secretKey,
}
}⚠️ 注意事项：
- Nessus 结构体及其字段（如 Ip, Port）也需首字母大写，否则即使函数导出成功，在外部也无法访问其字段；
- 返回 *Nessus（指针）比返回值类型更高效，避免结构体拷贝；若后续需调用 Nessus 的其他方法（如 nessus.Login()），也必须基于指针接收者；
- 确保 go.mod 文件存在且模块路径正确（如 module github.com/kkirsche/go-nessus），并在调用方项目中执行 go mod tidy 同步依赖。
调用方代码（attempt.go）保持不变即可正常工作：
package main
import (
"fmt"
"github.com/kkirsche/go-nessus"
)
func main() {
client := go_nessus.MakeClient("localhost", "8834", "ExampleAccessKey", "ExampleSecretKey")
fmt.Printf("Nessus client configured for %s:%s\n", client.Ip, client.Port)
}? 总结：
| 错误模式 | 正确模式 |
|---------|----------|
| func (n *Nessus) MakeClient(...) {}（方法） | func MakeClient(...) *Nessus {}（包函数） |
| 小写字段 ip string | 大写字段 Ip string |
| go install 单独构建（易忽略依赖） | 推荐 go run main.go 或 go build，配合 go mod 管理 |
遵循 Go 的导出约定，是编写可复用库的基础。一次规范，处处可用。
