批量检测指定目录下所有 .mp3 和 .wav 文件的 声道数（单/双声道） 和 采样率（Hz）

批量检测指定目录下所有 .mp3 和 .wav 文件的 声道数（单/双声道） 和 采样率（Hz）。

🔧 脚本：check_audio_info.py

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
批量检测音频文件声道数与采样率
支持格式：.mp3 / .wav
用法示例：
    python check_audio_info.py ./audios/
"""

import os
import sys
import glob
from pydub import AudioSegment

def check_audio_info(file_path: str):
    """读取单个音频文件的声道数与采样率"""
    ext = os.path.splitext(file_path)[1].lower()
    if ext not in ['.mp3', '.wav']:
        print(f"跳过不支持的格式: {file_path}")
        return

    try:
        audio = AudioSegment.from_file(file_path)
        channels = audio.channels
        sample_rate = audio.frame_rate

        print(f"🎵 文件: {os.path.basename(file_path)}")
        print(f"   ├─ 声道数: {channels} ({'单声道' if channels == 1 else '立体声'})")
        print(f"   └─ 采样率: {sample_rate} Hz\n")

    except Exception as e:
        print(f"❌ 读取文件出错: {file_path}")
        print(f"   错误信息: {e}\n")

def scan_directory(folder_path: str):
    """扫描文件夹内所有音频文件"""
    folder_path = os.path.abspath(folder_path)
    print(f"📂 正在扫描文件夹: {folder_path}\n")

    files = glob.glob(os.path.join(folder_path, "**/*.mp3"), recursive=True) \
          + glob.glob(os.path.join(folder_path, "**/*.wav"), recursive=True)

    if not files:
        print("⚠️ 没有找到音频文件 (.mp3 / .wav)")
        return

    for file_path in files:
        check_audio_info(file_path)

if __name__ == "__main__":
    if len(sys.argv) < 2:
        print("用法: python check_audio_info.py <目录路径>")
        sys.exit(1)

    folder = sys.argv[1]
    if not os.path.isdir(folder):
        print(f"❌ 路径无效: {folder}")
        sys.exit(1)

    scan_directory(folder)

⸻

📦 安装依赖

pip install pydub ffmpeg-python

# 系统必须安装 ffmpeg，可通过以下命令安装：
# macOS: brew install ffmpeg
# Ubuntu: apt-get install ffmpeg

⸻

🧩 使用示例

python check_audio_info.py ./samples/

输出示例：

📂 正在扫描文件夹: /Users/meixiu/samples/

🎵 文件: voice1.wav
   ├─ 声道数: 1 (单声道)
   └─ 采样率: 16000 Hz

🎵 文件: music.mp3
   ├─ 声道数: 2 (立体声)
   └─ 采样率: 44100 Hz