Python 中处理视频添加 / 替换音频

在 Python 中处理视频添加 / 替换音频，最常用的库是 moviepy（简单易用）和 ffmpeg-python（基于 FFmpeg，功能更底层）。以下是两种方案的详细实现，涵盖音频拼接、替换、音量调整、多音频混合等常见场景。

前置准备

安装依赖

核心库（moviepy封装了ffmpeg，推荐先装）

复制代码

pip install moviepy# 可选：直接调用ffmpeg的python封装（需先安装FFmpeg）
pip install ffmpeg-python# 安装FFmpeg（moviepy依赖，Windows需手动下载配置环境变量，Mac/Linux用brew/apt）
# Windows：https://ffmpeg.org/download.html，解压后将bin目录加入系统PATH
# Mac：brew install ffmpeg
# Ubuntu：sudo apt install ffmpeg

moviepy（简单高效，适合快速开发）

给视频替换 / 添加音频（覆盖原有音频）

复制代码

from moviepy.editor import VideoFileClip, AudioFileClip, CompositeAudioClip
def add_audio_to_video(video_path, audio_path, output_path, audio_volume=1.0):
    """
    给视频添加音频（替换原有音频）
    :param video_path: 原视频路径
    :param audio_path: 音频文件路径（mp3/wav等）
    :param output_path: 输出视频路径
    :param audio_volume: 音频音量（1.0为原音量，0.5为一半）
    """
    # 加载视频和音频
    video_clip = VideoFileClip(video_path)
    audio_clip = AudioFileClip(audio_path)
    
    # 调整音频音量
    audio_clip = audio_clip.volumex(audio_volume)
    
    # 匹配音频时长到视频时长（音频长则截断，短则循环/静音）
    if audio_clip.duration > video_clip.duration:
        audio_clip = audio_clip.subclip(0, video_clip.duration)
    else:
        # 音频较短时，循环音频（也可改为静音填充：audio_clip = audio_clip.audio_loop(duration=video_clip.duration)）
        audio_clip = audio_clip.audio_loop(duration=video_clip.duration)
    
    # 给视频设置新音频
    video_clip = video_clip.set_audio(audio_clip)
    
    # 导出视频（编码可选，默认libx264，音频aac）
    video_clip.write_videofile(
        output_path,
        codec="libx264",  # 视频编码
        audio_codec="aac",  # 音频编码
        fps=video_clip.fps,  # 保持原帧率
        threads=4  # 多线程加速
    )
    
    # 释放资源
    video_clip.close()
    audio_clip.close()
# 调用示例if __name__ == "__main__":
    add_audio_to_video(
        video_path="input_video.mp4",
        audio_path="background_music.mp3",
        output_path="output_video.mp4",
        audio_volume=0.6   # 音频音量60%
    )

保留原视频音频，叠加背景音乐（混合双音频）

复制代码

from moviepy.editor import VideoFileClip, AudioFileClip, CompositeAudioClip
def mix_audio_with_video(video_path, bgm_path, output_path, bgm_volume=0.3, original_volume=1.0):
    """
    保留原视频音频，叠加背景音乐
    :param bgm_volume: 背景音乐音量
    :param original_volume: 原视频音频音量
    """
    # 加载视频（含原音频）和背景音乐
    video_clip = VideoFileClip(video_path)
    original_audio = video_clip.audio.volumex(original_volume)
    bgm_clip = AudioFileClip(bgm_path).volumex(bgm_volume)
    
    # 匹配背景音乐时长
    bgm_clip = bgm_clip.subclip(0, video_clip.duration) if bgm_clip.duration > video_clip.duration else bgm_clip.audio_loop(duration=video_clip.duration)
    
    # 混合音频
    mixed_audio = CompositeAudioClip([original_audio, bgm_clip])
    
    # 设置混合音频并导出
    video_clip = video_clip.set_audio(mixed_audio)
    video_clip.write_videofile(
        output_path,
        codec="libx264",
        audio_codec="aac",
        threads=4
    )
    
    # 释放资源
    video_clip.close()
    bgm_clip.close()
# 调用示例
mix_audio_with_video("input_video.mp4", "bgm.mp3", "output_with_bgm.mp4", bgm_volume=0.2)

编译

报错

复制代码

from moviepy.editor import VideoFileClip, AudioFileClip; print('moviepy安装成功！') ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ModuleNotFoundError: No module named 'moviepy.editor'
现在的核心问题是：即使尝试了换源安装，Python 依然找不到 moviepy 的 editor 模块，这说明安装过程存在「表面成功但实际文件缺失」或「环境完全不匹配」的问题。以下是终极排查 + 修复步骤，覆盖所有可能的根因：
检查 moviepy 的安装目录和文件完整性
执行以下命令，找到 moviepy 的安装位置，并检查关键文件是否存在：
# 1. 查看moviepy的安装路径（复制Location字段）
python -m pip show moviepy
# 2. 进入该路径，检查editor.py是否存在（以Windows为例，Mac/Linux替换路径）# 示例：假设Location是 F:\tools\python\Lib\site-packages\moviepy  # 查看是否有 editor.py 文件（Mac/Linux用 ls 命令）

不存在

网址下载：moviepy · PyPI

进入桌面目录

cd F:\tools

本地安装wheel包

python -m pip install moviepy-2.0.0-py3-none-any.whl