如何使用pyshp修改Shapefile的DBF属性字段值

问题分析 #

第一段代码报错原因 #

w.record(record)的传参方式错误：record是列表类型，但w.record()需要传入可变参数（即把列表元素逐个传入），直接传列表会触发类型/属性错误。此外，仅读取记录后修改、再单独处理DBF的逻辑不够严谨。

第二段代码生成空文件原因 #

r.iterRecords()返回的是不可变元组，你尝试的rec[4] = 'Green'赋值操作完全不会生效，相当于没有修改任何记录；同时直接覆盖原文件时，pyshp的Writer仅处理DBF的逻辑可能导致文件关联异常。

正确实现代码 #

以下代码会保留原几何数据，仅修改DBF的指定字段值：

import shapefile
import shutil
import os

# 原文件路径
input_shp = r"J:\Test_Shapefile.shp"
# 输出文件路径（建议不要直接覆盖原文件，先输出到新路径）
output_shp = r"J:\Test_Out_Shapefile.shp"

# 1. 复制原几何相关文件（shp、shx、prj等）到输出路径
input_dir = os.path.dirname(input_shp)
input_name = os.path.basename(input_shp).replace(".shp", "")
output_dir = os.path.dirname(output_shp)
output_name = os.path.basename(output_shp).replace(".shp", "")

# 复制所有关联文件（除了dbf，我们要重新生成）
for ext in [".shp", ".shx", ".prj", ".sbn", ".sbx", ".shp.xml"]:
    src = os.path.join(input_dir, f"{input_name}{ext}")
    dst = os.path.join(output_dir, f"{output_name}{ext}")
    if os.path.exists(src):
        shutil.copy(src, dst)

# 2. 读取原Shapefile的字段结构和记录
r = shapefile.Reader(input_shp)
fields = list(r.fields)
records = r.records()  # 返回可修改的列表

# 3. 修改指定字段的值（假设Text字段是第5个元素，索引为4）
for rec in records:
    if rec[1] == 1:
        rec[4] = 'Green'
    elif rec[1] == 2:
        rec[4] = 'Blue'
    elif rec[1] == 3:
        rec[4] = 'Red'
    elif rec[1] == 4:
        rec[4] = 'Yellow'

# 4. 创建Writer，仅生成新的DBF文件
w = shapefile.Writer(dbf=output_shp)
w.fields = fields

# 写入修改后的记录，用*解包列表为可变参数
for rec in records:
    w.record(*rec)

w.close()

关键注意点 #

• 避免直接覆盖原文件：先输出到新路径，验证无误后再替换原文件，防止数据丢失。
• 优先使用records()而非iterRecords()：前者返回可修改的列表，后者返回不可变元组，无法修改字段值。
• 完整复制关联文件：确保prj投影文件、shx索引文件等辅助文件被复制，否则Shapefile无法正常加载。

内容的提问来源于stack exchange，提问作者Rob M