Go go-shp 关闭写入器前为何不能认为文件完整

Go 的 go-shp 写入器在 Write 返回后，并不代表 Shapefile 已经可以交给下游程序。Writer.Close() 会把正确的头部信息写入 .shp、.shx 和 .dbf，同时关闭底层文件；因此“最后一条记录写完”只是数据阶段结束，“关闭写入器”才是文件完成边界。若程序在 Close 前就让 GIS 工具、压缩任务或下一段 Go 代码读取文件，最容易遇到记录数、边界框或索引仍未定稿的问题。

写入记录，不等于文件已经完整

一个 Shapefile 不是单独的 .shp 文件。几何数据放在 SHP，空间索引放在 SHX，属性表放在 DBF。go-shp 的 Create 会创建 SHP 和 SHX；调用 SetFields 后才初始化 DBF 的字段布局。每次 Write 会写入几何、更新边界框，并为 SHX 追加索引；如果 DBF 已初始化，还会先准备一条空属性记录。

关键点在收尾：官方文档明确说明 Close 会在关闭前为 SHP、SHX、DBF 写入正确的头部。源码中的 Close 先写两份空间文件头，再补写 DBF 头，最后关闭文件句柄。因此，写循环结束后立刻复制文件、打包文件或交给读取器，时机仍然太早。

字段、几何和属性要保持同一行号

最小写入流程应先创建 Writer，再设置字段，随后写几何和属性。Write 返回从零开始的对象索引，这个索引就是 WriteAttribute 的行号。下面的示例用同一组点写出三个要素，并在函数返回前关闭写入器：

package main

import (
    "log"
    shp "github.com/jonas-p/go-shp"
)

func writePoints(path string, points []shp.Point) error {
    // Create 会准备 .shp 和 .shx；传入 basename 也可以让库补上 .shp。
    writer, err := shp.Create(path, shp.POINT)
    if err != nil {
        return err
    }
    // 保证正常返回、提前 return 时都会执行收尾；调用方须在此之后再读取文件。
    defer writer.Close()

    // SetFields 初始化 DBF，必须放在 WriteAttribute 之前。
    if err := writer.SetFields([]shp.Field{shp.StringField("NAME", 32)}); err != nil {
        return err
    }
    for i, point := range points {
        // row 是形状写入顺序，从零开始，不能随意使用业务主键代替。
        row := writer.Write(&point)
        if err := writer.WriteAttribute(int(row), 0, "P-"+string(rune('0'+i))); err != nil {
            return err
        }
    }
    return nil
}

func main() {
    // 这里只演示调用关系；生产代码还应把路径交给任务配置管理。
    if err := writePoints("out/points", []shp.Point{{X: 10, Y: 10}}); err != nil {
        log.Fatal(err)
    }
}

这个示例里的 defer 保护的是函数退出路径，不是“写完当前循环就立刻关闭”。如果后面还要读取、压缩或上传输出，应把写入函数返回作为完成信号；如果同一个函数必须继续处理文件，就显式调用 Close 后再打开读取。

为什么 Close 必须先于交付

go-shp 的 Close 没有返回错误值，所以它不是可以被忽略的“可选清理”。它承担了写头部的职责：SHP/SHX 需要最终文件长度、形状类型和边界框，DBF 需要最终记录数和字段信息。把文件交给下游前，至少要确保三个同名组件都由同一次写入完成。

仍然读到不完整文件时的排查清单

• 先查关闭位置：不要在 defer 所在函数返回前，把路径交给并发上传、压缩或读取任务。
• 再查组件是否同名：points.shp、points.shx、points.dbf 必须来自同一轮写入，不能混用旧文件。
• 再查字段顺序：SetFields 后按 Write 返回的行号写属性；字段长度不足会让 WriteAttribute 返回错误。
• 最后查异常路径：中途返回错误时保留临时目录，修复原因后重新生成一套完整组件，不要把半成品重命名成正式文件。

如果需要明确交付边界，可以让写入函数只返回目录或 basename，调用者拿到返回值后再启动下一阶段任务。这样比在写循环里轮询文件大小更可靠，因为文件大小增长不能证明头部已经完成。

相关问题

只写 SHP 不写 DBF 可以吗？

可以不设置属性字段，但仍要让 Writer 正常 Close；库会为没有初始化 DBF 的情况补建空字段表。

Close 能不能放在每次 Write 后？

不能。Close 是整个 Writer 事务的收尾动作，放在循环中会提前关闭底层文件，后续写入自然失效。

为什么 defer writer.Close 仍可能被下游读到旧文件？

因为 defer 只在当前函数返回时执行。如果下游任务在函数返回前启动，它与关闭动作之间没有完成同步。