CosyVoice 安装 openai-whisper 报错 ModuleNotFoundError 原因及解决方案

💡 为什么 --no-build-isolation 能解决

pip install -e . --no-build-isolation

这个命令告诉 pip："不要创建隔离的构建环境，直接在当前激活的虚拟环境中构建"

于是流程变成：

┌─────────────────────┐
│ 目标虚拟环境 │
│ (cosyvoice) │
├─────────────────────┤
│ ✓ setuptools 81.0.0 │ ←── 直接在同一个环境中执行构建
│ ✓ pkg_resources │ 和安装
│ ✓ 所有项目依赖 │
└─────────────────────┘
↓
pip install -e . (无隔离环境)

因为你的虚拟环境中已经有 setuptools，所以 import pkg_resources 可以成功执行。

📝 更好的修复方式

虽然 --no-build-isolation 解决了问题，但更好的做法是修改 setup.py，使其在隔离环境中也能工作：

import os
import platform
import sys
from setuptools import find_packages, setup

# 延迟导入 pkg_resources，或使用 try/except
def get_install_requires():
    """延迟解析 requirements.txt，避免构建时依赖"""
    requirements = []
    if sys.platform.startswith("linux") and platform.machine() == "x86_64":
        requirements.append("triton>=2.0.0,<3")
    # 只在需要时导入 pkg_resources
    try:
        import pkg_resources
        req_file = os.path.join(os.path.dirname(__file__), "requirements.txt")
        with open(req_file, encoding="utf-8") as f:
            requirements.extend([str(r) for r in pkg_resources.parse_requirements(f)])
    except ImportError:
        # 降级方案：简单读取 requirements.txt
        req_file = os.path.join(os.path.dirname(__file__), "requirements.txt")
        with open(req_file, encoding="utf-8") as f:
            requirements.extend([line.strip() for line in f if line.strip() and not line.startswith("#")])
    return requirements

def read_version(fname="whisper/version.py"):
    exec(compile(open(fname, encoding="utf-8").read(), fname, "exec"))
    return locals()["__version__"]

setup(
    name="openai-whisper",
    py_modules=["whisper"],
    version=read_version(),
    description="Robust Speech Recognition via Large-Scale Weak Supervision",
    long_description=open("README.md", encoding="utf-8").read(),
    long_description_content_type="text/markdown",
    readme="README.md",
    python_requires=">=3.8",
    author="OpenAI",
    url="https://github.com/openai/whisper",
    license="MIT",
    packages=find_packages(exclude=["tests*"]),
    install_requires=get_install_requires(),  # 使用函数延迟解析
    entry_points={"console_scripts":["whisper=whisper.transcribe:cli"]},
    include_package_data=True,
    extras_require={"dev":["pytest","scipy","black","flake8","isort"]},
)

🎯 总结

你使用的 --no-build-isolation 是完全正确的临时解决方案。对于长期使用，可以考虑向项目提交 PR 修改 setup.py，使其构建时不需要预先存在的 setuptools。