根本原因是 np.frombuffer 默认创建只读数组以保障安全,需显式设 writeable=True 且原始 buffer 可写(如 bytearray),bytes 不可写须先转换。

np.frombuffer 报错“Buffer is not writable” 的根本原因
因为 np.frombuffer 默认创建的是只读数组,而你后续尝试修改数组元素(比如赋值、+=、fill() 等),触发了 NumPy 的写保护检查。这不是 bug,是设计行为——底层 buffer(如 bytes、bytearray)本身可能不可写,NumPy 为安全起见默认设 writeable=False。
如何让 np.frombuffer 返回可写数组
关键在显式设置 writeable=True 参数,但前提是原始 buffer 本身支持写入:
-
bytes对象永远不可写 → 用np.frombuffer(b'123', dtype=np.uint8, writeable=True)会直接报错 -
bytearray或memoryview(指向可写内存)才允许开启写权限 - 常见修复写法:
data = bytearray([1, 2, 3, 4]) arr = np.frombuffer(data, dtype=np.uint8, writeable=True)
- 若只有
bytes,必须先转成bytearray:b = b'\x01\x02\x03' arr = np.frombuffer(bytearray(b), dtype=np.uint8, writeable=True)
为什么有时开了 writeable=True 还报错?
即使加了参数,仍可能失败,原因包括:
- 底层 buffer 已被标记为只读(例如某些 mmap 映射、C 扩展返回的 buffer)
- NumPy 版本较老(writeable 支持不完整,升级到 1.23+ 更稳妥
- 你用了
np.array(..., copy=False)包裹frombuffer结果,导致丢失 writeable 属性 - 调试时误用
arr.flags.writeable = True强行解锁 —— 这属于未定义行为,可能崩溃或静默失败
替代方案:什么时候不该硬刚 frombuffer
如果你只是想把二进制数据变成可修改的 NumPy 数组,且不强求零拷贝,更稳妥的做法是:
- 用
np.frombuffer(buf, dtype=...).copy()→ 显式复制,得到完全可写的普通数组 - 用
np.ndarray(shape=..., dtype=..., buffer=buf, writeable=True)→ 更底层,但需手动算 shape 和 stride - 从源头改:读文件时用
np.fromfile(...)或np.memmap,它们默认支持写(取决于文件打开模式)
零拷贝不是银弹;当 buffer 来源不确定、或写操作是刚需时,.copy() 反而是最省心的选择。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











