这篇内容来自一个典型的实战场景：用 AI 工具生成 Python 脚本，尝试批量合并一堆 ts 视频片段，结果第一次运行就翻车了。整个过程，从提需求、到翻车、再到排查修复，其实很能说明问题。下面就把这次完整的“debug”过程拆开看看。

先说下最初给 AI 的提示词：写一个 Python 脚本，去读取 E:\a video\Batty 文件夹下 index 子文件夹里的所有 ts 片段，按顺序合并成一个 mp4，存到 E:\aivideo，完事后删掉原始 ts 文件，并且每一步都要在屏幕上打印进度信息。

思路很清晰对吧？AI 也确实给了一个看起来完整的脚本。但第一次跑的时候，翻车了——合并没成功，输出文件夹里空空如也。

把这个问题反馈给 AI 后，它给出的诊断思路，其实挺有代表性，可以当成一份针对这类场景的“排雷手册”来看。

常见的坑在哪里

ffmpeg 环境没配好

这可能是最常见的“非代码”问题了。如果系统里根本没装 ffmpeg，或者装完没加到环境变量里，那 Python 脚本里调用的 ffmpeg 命令自然就石沉大海。解决办法也很直接：先在命令行里敲个 ffmpeg -version 确认一下。没返回版本信息？要么去官网下载安装，要么老老实实把 ffmpeg 的 bin 目录加到系统 Path 里。脚本里加段测试代码也是个好习惯，提前卡住，比合并到一半报错强。

文件路径的“特殊字符”陷阱

涉及文件路径操作的 Python 脚本，很多“未预期的失败”都源于路径里有中文、空格或特殊符号。ffmpeg 在处理命令行参数时，对这些字符可能“不太友好”。解决方案也不复杂——在生成用于合并的文件列表 file_list.txt 时，确保每个路径都用单引号包起来，像这样：file 'E:\a video\Batty\index\001.ts'，能规避掉一大半因路径引发的解析错误。

排序是个隐藏的大坑

ts 片段合并最怕的，就是顺序搞乱。如果源文件只是简单地按文件名用字符串排序，那 2.ts 排在 10.ts 后面这种经典错误就会重现。正确的做法是按文件名中的数字部分排——比如 ts_files.sort(key=lambda x: int(x.split('.')[0]))，前提是文件名本身就是纯数字，否则还得根据实际命名规则调整。

ffmpeg 命令参数没对齐

核心的合并命令 ffmpeg -f concat -safe 0 -i file_list.txt -c copy output.mp4 一般够用。如果还是搞不定，可以试试加上 -vsync vfr 参数，有时候能解决时间戳不一致导致的合并失败问题。

权限问题

虽然不常遇到，但该确认的还是要确认：脚本有没有权限读取源文件、写入目标文件夹？必要的时候，用管理员身份运行一下。

如何高效定位问题

最直接的方法，就别让错误信息悄悄溜走。在脚本里用 subprocess.run 跑 ffmpeg 命令时，把 capture_output=True, text=True 带上，然后检查 result.returncode。不是 0 的话，就把 result.stderr 打印出来。ffmpeg 的错误日志往往能直接指出问题所在，比自己瞎猜高效得多。

修正后的脚本长什么样

把这些排查点都补上后，修正后的脚本就变成了下面这个样子。核心逻辑没变，但每个环节都加上了必要的检查、排序、转义和错误捕获，已经是一个可以稳定运行的版本了。

import os
import subprocess

# 定义文件夹路径
folders = [
    r"E:\a video\Batty"
]

# 输出文件夹
output_folder = r"E:\aivideo"

# 确保输出文件夹存在
if not os.path.exists(output_folder):
    os.makedirs(output_folder)
    print(f"创建输出文件夹: {output_folder}")

# 遍历每个文件夹
for folder in folders:
    index_folder = os.path.join(folder, "index")

    if os.path.exists(index_folder):
        print(f"正在处理文件夹: {index_folder}")

        ts_files = [f for f in os.listdir(index_folder) if f.endswith('.ts')]
        ts_files.sort(key=lambda x: int(x.split('.')[0]))  # 按数字名排序

        file_list_path = os.path.join(index_folder, "file_list.txt")
        with open(file_list_path, "w", encoding="utf-8") as file_list:
            for ts_file in ts_files:
                file_list.write(f"file '{os.path.join(index_folder, ts_file)}'\n")
        print(f"生成文件列表: {file_list_path}")

        output_video = os.path.join(output_folder, os.path.basename(folder) + ".mp4")

        ffmpeg_command = [
            "ffmpeg", "-f", "concat", "-safe", "0", "-i", file_list_path, "-c", "copy", output_video
        ]
        print(f"正在合并视频: {output_video}")
        result = subprocess.run(ffmpeg_command, capture_output=True, text=True)

        if result.returncode != 0:
            print("ffmpeg 合并失败，错误信息：")
            print(result.stderr)
        else:
            print("ffmpeg 合并成功。")

            # 删除.ts文件
            for ts_file in ts_files:
                os.remove(os.path.join(index_folder, ts_file))
                print(f"删除文件：{os.path.join(index_folder, ts_file)}")

            os.remove(file_list_path)
            print(f"删除文件列表: {file_list_path}")

        print(f"完成处理文件夹: {index_folder}")
    else:
        print(f"文件夹 {index_folder} 不存在，跳过处理。")

print("所有文件夹处理完成。")

这次运行修改后的脚本，ts 视频合并就成功完成了。说到底，AI 写的代码就像是个“初稿”，真正能跑起来的版本，往往还需要通过一次实战 debug 来打磨。