VideoFileClip读取视频易因中文/空格路径或H.265编码报错，需用绝对路径并转H.264；subclip需校验时间边界；concatenate_videoclips要统一音频处理；导出时应指定preset和bitrate，并及时close()。
用 VideoFileClip 读取多个视频时，路径和编解码兼容性最容易出错
直接传入中文路径或带空格的路径会触发 OSError: MoviePy error: failed to read the duration of file xxx；更隐蔽的问题是某些手机录的 MP4（如 H.265 编码）会被 VideoFileClip 读成 0 秒——moviepy 默认依赖 ffmpeg，但不自动处理硬解或缺失 codec。
- 统一用绝对路径，并用
os.path.abspath()或pathlib.Path.resolve()规范化 - 遇到读取后
clip.duration为 0 或报错，先用命令行检查：ffprobe -v quiet -show_entries format=duration -of default=nw=1 input.mp4 - 确认是 H.265 问题？用 ffmpeg 转成 H.264：
ffmpeg -i in.mp4 -c:v libx264 -c:a aac out.mp4 - 避免在循环中反复创建/关闭 clip，读取后立刻调用
clip.close()（尤其内存受限时）
按时间戳自动剪辑用 subclip()，但起止时间必须落在原片范围内
subclip(t_start, t_end) 看似简单，但传入超限时间（比如原片只有 10 秒却剪 subclip(8, 15)）不会报错，而是静默截到末尾——结果时长不对，还难排查。
- 剪辑前务必校验：
if t_end > clip.duration: t_end = clip.duration - 批量处理时，把时间列表存成元组列表更安全：
cuts = [(0, 3.5), (8.2, 12.7), (15.1, 18.0)]，再逐个clip.subclip(*cut) - 需要毫秒级精度？传 float（如
12.345），moviepy 内部支持，但底层 ffmpeg 可能四舍五入到帧边界（取决于帧率） - 不要对已 subclip 过的 clip 再 subclip，容易因元数据丢失导致时长计算偏差
合并多个剪辑片段用 concatenate_videoclips()，注意 audio 和 method 参数
默认 concatenate_videoclips(clips) 会尝试合成音频轨道，但如果某段 clip 没音频（比如纯画面截图生成的 clip），就会抛 AttributeError: 'NoneType' object has no attribute 'set_duration'。
- 强制统一处理音频：加参数
with_aud=False（全部丢弃音频），或with_aud=True（默认，但要求每段都有 audio） - 如果部分 clip 无音频，先补空音频：
clip = clip.without_audio().with_audio(AudioArrayClip(np.zeros((int(clip.fps * clip.duration), 2)), fps=clip.fps)) - 想让衔接更自然？用
method="compose"（而非默认"chain"），它会保留各 clip 原始分辨率/帧率，但要求尺寸一致，否则报错Size mismatch - 导出前务必检查最终 clip 的
.size和.fps，合并后可能被降频或拉伸
导出时用 write_videofile() 卡住或体积爆炸？关键在 preset 和 bitrate
不设参数直接调 clip.write_videofile("out.mp4")，moviepy 会用 ffmpeg 默认 preset（通常是 medium），编码慢、CPU 占满，且输出文件可能比源大几倍（尤其文字多的屏幕录制）。
立即学习“Python免费学习笔记（深入）”；
- 提速加
preset="fast"或"ultrafast"（质量略降，但日常剪辑够用） - 控体积加
bitrate="1000k"（单位是 kbps），常见值：720p 用"2000k"，1080p 用"5000k" - 想最小体积且接受稍高耗时？加
codec="libx265"+bitrate="1500k"（需 ffmpeg 编译支持 x265） - Windows 上遇到权限错误或“文件正被占用”？加
threads=1避免多线程冲突
实际跑通的关键点就这些：路径和编码先扫清，时间截取做边界防护，合并时管好音频和尺寸，导出盯紧 preset 和 bitrate。最常漏的是 clip.close() 和 t_end 校验——这两处不处理，脚本可能本地跑通，一放到服务器或换批视频就崩。
