如何在 Windows 上正确配置并运行 RVC-CLI 的 Conda 环境

本文详解在 windows 系统中安装 anaconda、初始化 conda 环境、激活指定环境,并成功运行 rvc-cli 项目的完整流程,解决 `conda not recognized`、`env/python not found` 及依赖冲突等常见问题。

RVC-CLI 是一个基于 Python 的语音转换命令行工具,其运行依赖特定版本的 NumPy、Parselmouth 等科学计算库,因此官方推荐使用 Conda 管理环境——这不仅能隔离依赖,还能自动解决 Windows 下音频处理库(如 Praat/Parselmouth)的二进制兼容性问题。

✅ 第一步:确认并安装 Conda

你遇到的 conda is not recognized 错误表明系统尚未安装或未正确配置 Conda。请按以下步骤操作:

  1. 下载并安装 Miniconda(轻量版,推荐)
    访问 https://www./link/99a03297cd334305eeb21e19bf0ad056,下载 Windows x86-64 Installer(Python 3.9+),安装时务必勾选:

    ✅ Add Anaconda to my PATH environment variable ✅ Register Anaconda as my default Python
  2. 验证安装
    重启命令提示符(CMD 或 PowerShell),执行:

    conda --version

    若输出类似 conda 24.5.0,说明安装成功;否则请重新安装并确保勾选 PATH 选项。

✅ 第二步:初始化并激活 Conda 环境

RVC-CLI 的 install.bat 脚本本质是调用 Conda 创建并配置专用环境(通常名为 rvc 或 base)。若该脚本未执行或失败,请手动补全:

# 进入项目根目录(含 install.bat 和 main.py 的文件夹)
cd C:\path\to\RVC_CLI

# 初始化 Conda 环境(若 install.bat 已运行过,可跳过此步)
conda env create -f environment.yml  # 若项目提供 environment.yml
# 或直接激活基础环境(常见于 RVC-CLI 默认配置)
conda activate base

⚠️ 注意:env/python main.py 中的 env/ 并非 Windows 原生路径,而是 Linux 风格的虚拟环境子目录引用(如 venv/bin/python)。在 Windows + Conda 场景下,不应直接访问 env/python —— 正确做法是先 conda activate,再用当前 shell 的 python 命令运行脚本。

✅ 第三步:运行主程序并处理典型错误

激活环境后,执行:

python main.py

若仍报错,请针对性处理:

错误现象 原因与解决方案
ModuleNotFoundError: No module named 'parselmouth' Conda 环境未安装 praat-parselmouth:运行 conda install -c conda-forge praat-parselmouth(不要用 pip 安装,Windows 下 pip 版本常编译失败)
numpy 1.21 conflicts 环境存在多源混装(pip + conda)。执行 conda list numpy 查看来源,然后 conda install numpy=1.21.6 强制统一版本,并避免后续使用 pip install
OSError: Cannot find Praat executable Parselmouth 需要 Praat 二进制支持。Conda 安装 praat-parselmouth 会自动附带,无需手动下载 Praat

✅ 补充建议:使用 PowerShell 替代 CMD(更稳定)

部分 Conda 初始化脚本在 CMD 中无法加载环境变量。推荐:

  • 管理员身份运行 Windows PowerShell
  • 执行 conda init powershell → 关闭并重开 PowerShell
  • 再运行 conda activate base && python main.py

总结

RVC-CLI 的核心痛点不在代码本身,而在 Windows 下科学计算生态的环境隔离。牢记三原则:
? 始终用 Conda 而非 pip 管理核心依赖(尤其是 Parselmouth、NumPy、PyTorch)
? conda activate 是运行前提,而非 env/python 这类硬编码路径
? 遇到报错优先检查 conda list 输出,确认包来源与版本一致性

完成上述步骤后,你将能稳定启动 RVC-CLI 并开始语音转换任务。