Go go-shp 怎样读取DBF属性字段

使用 Go 的 go-shp 读取 Shapefile 时，DBF 属性不是从几何对象里“顺手取出”的，而是通过字段定义、记录行号和字段下标重新对齐。最实用的写法是：先调用 Fields() 取得 DBF 字段顺序，在 Next() 循环中用 Shape() 返回的零基记录号，再把这个行号传给 ReadAttribute(row, field)。

官方地址：https://pkg.go.dev/github.com/jonas-p/go-shp

一句话记忆：Fields 告诉你“第几列是什么”，Shape 告诉你“当前是第几行”，ReadAttribute 用行号和列号取出字符串值；循环结束后再用 Err() 判断是否真的出错。

先把 Shapefile 和 DBF 的对应关系理清

一个常见误区是把 .shp 当成包含所有信息的单一文件。对本文的读取任务来说，可以把几何记录和 DBF 属性看成两张按记录编号对齐的表：几何记录描述点、线或面，DBF 行保存名称、编码、类别等属性。go-shp 的 Reader 把两部分放进同一个读取对象，但属性访问仍然需要显式提供行号和字段下标。

准备依赖并打开文件

先在 Go module 中加入依赖。传给 shp.Open 的是 Shapefile 主路径，例如 roads.shp；同目录下应能找到与它配套的索引和属性文件。打开成功后立刻注册关闭动作，避免读取中途返回时忘记释放文件句柄。

# 在当前 Go module 中加入 go-shp 依赖
go get github.com/jonas-p/go-shp

package main

import (
	\"log\"

	shp \"github.com/jonas-p/go-shp\"
)

func openShape(path string) *shp.Reader {
	// Open 负责建立对 Shapefile 的读取对象，错误要在进入循环前处理。
	reader, err := shp.Open(path)
	if err != nil {
		log.Fatalf(\"打开 Shapefile 失败: %v\", err)
	}
	// Reader 持有文件资源，函数返回前统一关闭它。
	defer func() {
		if err := reader.Close(); err != nil {
			log.Printf(\"关闭 Shapefile 失败: %v\", err)
		}
	}()
	return reader
}

上面这个片段只用来说明打开和清理边界。实际读取时不要让局部函数在返回 Reader 后立刻触发 defer Close；更稳妥的做法是把打开、读取和关闭放在同一个函数中。

先用 Fields 认识 DBF 的字段顺序

reader.Fields() 返回 []shp.Field。字段切片的下标就是之后传给 ReadAttribute 的 field 参数，因此不应该只记住某个字段名而忽略它在当前文件中的列位置。

fields := reader.Fields()
for fieldIndex, field := range fields {
	// Field 的 String 方法可用于输出字段名，fieldIndex 保留列位置。
	fmt.Printf(\"列 %d: %s\\n\", fieldIndex, field.String())
}

Field 还保存字段类型、长度和精度等 DBF 元数据。本文的读取接口最终返回字符串，所以如果业务层需要整数、浮点数或日期，应在边界处做明确转换，并保留转换失败的上下文。

在 Next 循环里用 Shape 返回的行号读取属性

真正的对齐点在 Shape() 返回的第一个值。这个值是当前几何记录的零基编号，可以直接作为 DBF 行号传入 ReadAttribute。不要把它替换成循环次数之外的固定值，也不要把字段下标误当成行号。

package main

import (
	\"fmt\"
	\"log\"

	shp \"github.com/jonas-p/go-shp\"
)

func dumpAttributes(path string) error {
	// Reader 同时负责几何记录和 DBF 属性的顺序读取。
	reader, err := shp.Open(path)
	if err != nil {
		return fmt.Errorf(\"打开 Shapefile: %w\", err)
	}
	defer func() {
		// 关闭错误只能记录，不能覆盖前面已经得到的读取错误。
		if closeErr := reader.Close(); closeErr != nil {
			log.Printf(\"关闭 Shapefile: %v\", closeErr)
		}
	}()

	fields := reader.Fields()
	for reader.Next() {
		row, geometry := reader.Shape()
		// row 是当前几何对应的零基 DBF 行号，geometry 可继续做类型分支。
		fmt.Printf(\"记录 %d，几何包围盒: %+v\\n\", row, geometry.BBox())
		for fieldIndex, field := range fields {
			// fieldIndex 是列下标，row 与它组合后才定位到一个属性单元格。
			value := reader.ReadAttribute(row, fieldIndex)
			fmt.Printf(\"  %s = %s\\n\", field.String(), value)
		}
	}
	// Next 返回 false 可能是正常到达末尾，也可能是读取异常。
	if err := reader.Err(); err != nil {
		return fmt.Errorf(\"读取 Shapefile: %w\", err)
	}
	return nil
}

这段代码的关键不是打印格式，而是两个索引的职责分离：row 选中一条记录，fieldIndex 选中这一行中的一列。这样即使 DBF 有多个字段，也不会把所有记录都读成第一行。

把字符串属性交给业务层前做边界转换

ReadAttribute 的返回值是字符串。对于展示、导出或日志记录，可以直接保留；对于面积、编号、日期等业务字段，建议在读取边界处显式转换，并把字段名放进错误信息。这样定位问题时能知道是哪个文件、哪一行、哪一列出了格式问题。

func parseNumber(row int, fieldIndex int, field shp.Field, value string) (float64, error) {
	// 先保留字段名，转换失败时调用方能定位 DBF 的具体列。
	number, err := strconv.ParseFloat(strings.TrimSpace(value), 64)
	if err != nil {
		return 0, fmt.Errorf(\"第 %d 行字段 %s 转数字: %w\", row, field.String(), err)
	}
	return number, nil
}

空字符串不一定代表文件损坏，它可能是业务上的缺失值。是否转成零值、指针或可选类型，应由业务规则决定，不要让通用读取函数替你猜测。

循环结束后检查 Err，避免把 EOF 当成异常

Next 返回 false 时，循环自然结束并不等于读取失败。按照 go-shp 的读取习惯，应在循环外调用 Err()：返回 nil 才表示没有记录级读取错误；如果返回非 nil，再把它交给上层处理。

for reader.Next() {
	// 这里处理当前记录和它对应的 DBF 属性。
}

	// 循环结束后区分“读完了”和“读坏了”。
if err := reader.Err(); err != nil {
	return fmt.Errorf(\"读取结束时发现错误: %w\", err)
}

资源清理也要和错误处理分开：读取错误由返回值传递，关闭错误至少要记录；如果程序需要严格保证写入或释放成功，则再结合具体调用场景决定是否提升关闭错误。

常见问题

为什么 ReadAttribute 读出来的值总是重复？

通常是把行号固定成了 0，或者没有使用 Shape() 返回的当前记录号。应该在每次 Next 成功后重新取得 row，再调用 ReadAttribute(row, fieldIndex)。

Fields 的下标从 1 开始吗？

不是。Go 切片和该接口的行、字段参数都按零基下标使用，第一列是 0，第一条记录也是 0。

没有 DBF 文件还能读取几何吗？

几何读取和属性读取是两个不同关注点，但本文的属性流程依赖 DBF 字段和记录。缺少配套 DBF 时，不应假设 Fields 与 ReadAttribute 仍能提供完整业务字段。

总结

用 go-shp 读取 DBF 属性字段，可以固定成一条清晰的链路：打开 Reader，先用 Fields() 取得列定义；在 Next() 循环中调用 Shape() 取得当前零基行号；再用 ReadAttribute(row, fieldIndex) 读取单元格；最后调用 Err() 区分正常结束和真实错误。只要始终把“行号”和“字段下标”分开，Shapefile 的几何与属性就能稳定对齐。