os.truncate()是最简单可靠的开头截断方法,仅保留前N字节,不读取内容、毫秒级完成,但不可逆且不支持扩展;保留末尾需用seek+read+重写,须用二进制模式并注意编码边界。

用 os.truncate() 直接截断文件最简单
如果目标只是把一个或多个文件硬性砍到指定字节长度(比如都留前 1024 字节),os.truncate() 是最轻量、最可靠的选择。它不读取内容,不复制数据,直接修改文件系统元数据,毫秒级完成。
注意:该操作不可逆,且只支持「从末尾截断」——即保留开头部分,丢弃后面所有字节。
- 必须以可写模式打开文件(
'r+'或'a+'),不能用'r'(只读会报OSError: [Errno 22] Invalid argument) - 若目标大小大于当前文件长度,
truncate()不会扩展文件(不会补零或空格) - 建议先用
os.path.getsize()判断是否需要截断,避免对小文件误操作
import os
target_size = 1024
for path in ['a.log', 'b.log', 'c.log']:
if os.path.getsize(path) > target_size:
with open(path, 'r+') as f:
f.truncate(target_size)
批量处理时用 pathlib.Path 更清晰
当路径来源多样(如 glob 匹配、子目录递归、配置列表),pathlib 的链式调用比 os.path + open 组合更易读、容错更好。
关键点在于:必须显式调用 .resolve() 或确保路径存在,否则 .stat().st_size 会抛 FileNotFoundError;且 .open('r+') 要捕获 PermissionError(比如日志文件被其他进程独占锁定)。
立即学习“Python免费学习笔记(深入)”;
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
-
Path.open()默认不自动创建父目录,但截断操作本身不要求父目录可写 - Windows 下对正在被记事本打开的文件调用
truncate()会失败,Linux 下对被tail -f监听的文件通常不影响 - 避免在循环中重复计算
st_size,可先过滤再操作
from pathlib import Path
files = list(Path('logs/').glob('*.log'))
target = 512
for p in files:
try:
if p.stat().st_size > target:
with p.open('r+') as f:
f.truncate(target)
except (OSError, PermissionError) as e:
print(f"skip {p}: {e}")
需要保留末尾 N 字节?得用 seek() + read() + 写入
os.truncate() 只能砍尾,没法“留后截前”。如果需求是「每个文件只保留最后 1024 字节」,就必须读取末段再重写——此时性能和内存占用成为关键约束。
大文件(>100MB)直接 f.read() 全读进内存会爆,必须用偏移跳转:f.seek(0, 2) 定位到末尾,f.seek(max(0, f.tell() - N)) 回退,再读取剩余部分。但要注意文本文件的编码边界问题(比如 UTF-8 多字节字符被截断会导致解码错误)。
- 二进制模式(
'rb'/'wb')是必须的,避免换行符转换和编码干扰 - 若目标大小超过文件实际长度,应全量读取,而非 seek 负偏移(会触发
IOError) - 写入前最好先
os.replace()备份原文件,或用临时文件 + 原子重命名
def truncate_tail(filepath: str, n: int):
with open(filepath, 'rb') as f:
f.seek(0, 2)
size = f.tell()
if size <= n:
return
f.seek(max(0, size - n))
content = f.read()
with open(filepath, 'wb') as f:
f.write(content)
为什么不用 shutil.copyfileobj() 或分块读写?
有人想用 shutil.copyfileobj() 配合 io.BytesIO 缓冲来“流式截断”,这反而增加复杂度且无收益。因为截断本质是长度控制,不是复制——只要知道起点和终点,一次 seek + read + write 就够了。
真正需要分块的场景,其实是「按行截断」或「按 JSON 对象截断」这类语义截断,而非字节截断。字节层面强行分块读写(比如每次读 8KB)只会放大 I/O 次数,还引入边界处理逻辑(比如最后一块不足 8KB 怎么判断是否已够 N 字节)。
- 除非文件极大(>10GB)且内存严格受限,否则单次读取末段更高效
-
copyfileobj适合「从 A 复制到 B 并限长」,但你这里的目标是原地修改,不是复制 - 所有基于
open(..., 'w')的重写方案都会清空原文件 inode 时间戳(mtime重置),而truncate()保持原时间戳不变
文件截断看着简单,但「保留开头」和「保留结尾」是两种完全不同的 I/O 模式,底层行为、错误类型、适用场景都不同。选错方法会导致权限失败、编码损坏或意外清空,动手前先确认你要的是哪一种。

















