针对 Mac 系统配置 RVC(Retrieval-based Voice Conversion)变声环境,根据官方文档,您可以按照以下步骤进行操作:

1. 基础环境准备

  • Python 环境:确保您的系统中安装了 Python 3.8 或更高版本,这是运行所有 RVC 命令的前提条件。
  • 安装 FFmpeg:FFmpeg 是音频处理的核心组件。如果您电脑中尚未安装,Mac 用户通常可以通过包管理器(如 Homebrew)进行安装。请注意,如果音频路径包含特殊字符(如空格、括号或中文),FFmpeg 读取时可能会报错,建议使用简洁的英文路径。

2. 安装依赖项

与 Windows 用户主要使用 pip 不同,官方为 Mac 用户提供了专门的安装脚本:

  • 执行脚本:您可以通过运行根目录下的 run.sh 脚本来自动安装所需的依赖项。

3. 准备预训练模型

RVC 的推理和训练功能无法独立运行,需要额外的预训练模型支持:

  • 您可以从官方提供的 Huggingface 空间下载所需的预训练模型。
  • 这些文件通常包括用于不同采样率(如 32k、40k、48k)的基础权重文件。

4. 启动程序

  • 启动 WebUI:配置完成后,您可以根据官方 README 的引导启动 WebUI 界面进行模型推理或训练。
  • 实时变声:虽然文档中提到的 go-realtime-gui.bat 是针对 Windows 的批处理文件,但 RVC 也支持实时变声功能,其端到端延迟通常在 170ms 左右。

5. 常见问题与排查

  • 连接错误 (Connection Error):如果 WebUI 弹出"Expecting value: line 1 column 1"错误,通常是因为开启了系统全局代理或 LAN 代理。请关闭代理后刷新页面。
  • 模型识别:如果您在训练后找不到模型,请点击"Refresh timbre list(刷新音色列表)"。请确保您使用的是 weights 文件夹下约 60MB+ 的 .pth 推理模型,而不是 logs 文件夹下的几百 MB 的训练断点文件。
  • 显存问题:虽然 Mac 主要使用其统一内存,但如果遇到内存/显存不足(Out of memory),可以在训练时尝试减小 batch_size,或者在推理时调整 config.py 中的 x_padx_query 等设置。
📖 延伸阅读:查看 Windows 安装图文教程 了解 Windows 系统的安装流程,或查看 运行环境配置指南 了解详细的硬件与依赖配置。