go 语言中实现接口需确保结构体及其字段、方法均为导出（首字母大写），否则跨包调用时会因不可见而编译失败。本文详解接口实现的导出规则、结构体定义规范及实例化方式。
go 语言中实现接口需确保结构体及其字段、方法均为导出（首字母大写），否则跨包调用时会因不可见而编译失败。本文详解接口实现的导出规则、结构体定义规范及实例化方式。
在 Go 中，接口（interface）是实现多态和抽象的核心机制，但其实际使用依赖于严格的可见性规则：只有首字母大写的标识符（即导出名）才能被其他包访问。你遇到的错误：
./poke.go:111: cannot refer to unexported name poke.txtScanner
根本原因在于 txtScanner（小写 t）及其字段 txt 均为未导出（unexported）标识符，导致 main 包无法引用或初始化该类型。
✅ 正确做法：统一使用导出命名
- 结构体名必须首字母大写：txtScanner → TxtScanner
- 字段名必须首字母大写：txt string → Txt string
- 接口方法签名自动导出（只要方法名大写，如 Scan()），无需额外处理
- 构造函数建议导出（如 NewTxtScanner），便于外部安全创建实例（推荐替代 newTxtScanner）
以下是修正后的关键文件示例：
types.go
package poke
type ScanResult struct {
// 可添加具体字段，如 Status, Data 等
}scanner.go
package poke
type Scanner interface {
Scan() *ScanResult
}txt_scanner.go（推荐导出构造函数）
package poke
type TxtScanner struct {
Txt string // 字段导出，支持跨包赋值与访问
}
// NewTxtScanner 是导出的构造函数，语义清晰且符合 Go 惯例
func NewTxtScanner(txt string) Scanner {
return TxtScanner{Txt: txt}
}
// Scan 方法签名以大写字母开头，自动满足 Scanner 接口
func (ts TxtScanner) Scan() *ScanResult {
// 实际扫描逻辑
result := ScanResult{}
// ... 处理 txt 并填充 result
return &result
}cmd/poke.go（主程序）
package main
import "github.com/achanda/poke"
func main() {
// ✅ 方式 1：通过导出构造函数创建（推荐）
scanner := poke.NewTxtScanner("example.txt")
result := scanner.Scan()
// ✅ 方式 2：直接字面量初始化（需确保结构体及字段均导出）
// scanner2 := poke.TxtScanner{Txt: "test.txt"}
// result2 := scanner2.Scan()
_ = result // 避免未使用警告
}⚠️ 注意事项
- 不要混用大小写：txtScanner 和 TxtScanner 是两个完全不同的类型；Go 不区分大小写的“别名”仅存在于同包内，跨包无效。
- 字段导出影响封装性：若不希望外部直接修改字段，应避免导出字段，改用导出方法（如 GetTxt() / SetTxt()）控制访问。
- 接口变量可指向任意实现：var s poke.Scanner 可赋值为 TxtScanner、JSONScanner 等任意满足 Scan() *ScanResult 签名的类型，这是接口解耦的关键。
- 构造函数命名惯例：Go 社区约定使用 NewXxx（而非 newXxx）作为导出构造函数名，提升可读性与一致性。
遵循导出规则 + 清晰的构造函数设计，即可安全、灵活地在 Go 中实现和使用接口，实现松耦合、易测试的模块化架构。
