### 安装与环境配置 在使用 Spleeter 之前，需要确保 Python 环境已正确安装并配置。推荐使用 Python 3.5 至 3.7 的版本，并将其路径加入系统环境变量中。随后可以使用 pip 安装 Spleeter 及其依赖库： ```bash pip install spleeter ``` 为了支持音频处理，还需要安装 FFmpeg 和相关音频处理库，例如 librosa 和 numba。可以通过以下命令安装这些依赖项： ```bash conda install -c conda-forge ffmpeg libsndfile pip install librosa pip install numba==0.48.0 -i https://mirrors.aliyun.com/pypi/simple/ ``` 此外，建议使用虚拟环境来管理项目依赖，以避免与其他项目的库发生冲突 [^4]。 ### 命令行使用方式 Spleeter 提供了简单的命令行接口用于快速执行音频分离任务。例如，要将一个音频文件中的人声和伴奏分离，可以运行如下命令： ```bash python -m spleeter separate -i input.mp3 -o output_dir ``` 该命令会将 `input.mp.json` 中的音频文件按照预设模型进行分离，并将结果保存到指定输出目录 `output_dir` 中 [^1]。 如果希望指定不同的分离模型（如 2 stems、4 stems 或 5 stems），可以在命令中添加 `-p` 参数： ```bash python -m spleeter separate -i input.mp3 -p spleeter:4stems -o output_dir ``` 此命令将音频分为四个部分：人声、鼓、贝斯和其他乐器 [^3]。 ### Python 脚本调用 除了命令行方式，还可以通过编写 Python 脚本来实现更灵活的控制。以下是一个示例脚本，展示如何使用 Spleeter API 来分离音频文件： ```python from spleeter.separator import Separator from spleeter.utils.audio.adapter import get_default_audio_adapter # 创建默认音频适配器实例 audio_loader = get_default_audio_adapter() # 加载音频文件 sample_rate = 44100 waveform, _ = audio_loader.load('input.mp3', sample_rate=sample_rate) # 初始化分离器 separator = Separator('spleeter:2stems') # 执行分离操作 prediction = separator.separate(waveform) # 将结果写入文件 import numpy as np np.savez_compressed('output.npz', **prediction) ``` 上述代码首先加载了一个音频文件，然后初始化了一个基于 2 stems 模型的分离器，并对音频进行了分离。最后，它将分离后的音轨保存为 `.npz` 文件 [^1]。 ### 分离特定声部 如果只需要分离特定的声部（如仅提取人声），可以使用自定义脚本实现。下面是一个示例脚本 `separate_stem.py`，展示了如何专门提取人声音轨： ```python import sys from spleeter.separator import Separator def main(): if len(sys.argv) < 3: print("Usage: python separate_stem.py <input_file> <output_directory>") return input_file = sys.argv[1] output_dir = sys.argv[2] # 初始化分离器 separator = Separator('spleeter:2stems') # 执行分离 separator.separate_to_file(input_file, output_dir) if __name__ == "__main__": main() ``` 运行该脚本时，传入输入音频文件路径和输出目录即可完成人声的提取 [^1]。 ### 遇到问题的解决方法 - **命令无法执行**：尝试使用完整路径调用 Spleeter，例如： ```bash python -m spleeter separate -i input.mp3 -o output_dir ``` - **依赖库冲突**：若出现 numba 和 librosa 版本不兼容的问题，可尝试重新安装兼容版本 [^4]。 - **分离效果不佳**：更新 Spleeter 到最新版本通常能改善分离质量 [^2]。 ---