应停用python setup.py install，因其已被python官方弃用；真因需查报错前后的“complete output”，常见有setuptools缺失、系统编译依赖不足、权限问题等；正确做法是统一使用pip命令安装，如pip install -e .或pip install --no-binary=:all: package-name。
看到 setup.py install error 就该停手，别硬跑
Python 官方早在 2020 年就明确弃用 python setup.py install，现在 pip（≥21.3）、setuptools（≥60）会直接报 SetuptoolsDeprecationWarning，甚至拒绝执行。错误本身不是“装不上”，而是你正在用已被淘汰的安装路径——它绕过了 pip 的依赖解析、元数据校验和 wheel 缓存机制，极易触发权限、路径、版本错位问题。
Command "python setup.py egg_info" failed with error code 1 怎么定位真因
这个报错是 pip 在准备元数据阶段失败的通用提示，真正原因藏在它上面几行或下面的 “Complete output” 里。常见真实错误包括：
Ai Podcast Pipeline
下载
从QuickView趋势笔记生成韩语AI播客包，含双人主持脚本（Callie×Nick）、Gemini多说话人TTS音频、字幕时间轴与渲染修正、缩略图+MP4包装及YouTube标题/描述输出。支持完整版（15~20分钟）和压缩版（5~7分钟）。
-
ModuleNotFoundError: No module named 'setuptools'：基础依赖缺失，运行python -m ensurepip --upgrade补全 -
Error: pg_config executable not found：源码包（如psycopg2）缺系统级编译依赖，需先装libpq-dev（Ubuntu）或postgresql-devel（CentOS） -
ERROR: Cannot execute `setup.py` since setuptools is not available：setuptools 版本太高（如 ≥69.5）与旧项目不兼容，降级到setuptools==69.0.0 -
error: can't create or remove files in install directory：没权限写入系统 site-packages，加--user参数或换用虚拟环境
替代 setup.py install 的三类安全做法
所有操作都应通过 pip 驱动，而非直接调用 setup.py：
- 本地源码目录安装（开发模式）：
pip install -e .—— 自动处理依赖、支持代码热更新 - 本地 tar.gz / zip 包安装：
pip install ./package-1.2.3.tar.gz—— pip 自动解压、构建 wheel、校验依赖 - 强制跳过 wheel 使用源码（极少数必要场景）：
pip install --no-binary=:all: package-name—— 但必须确保系统编译工具链（gcc、cmake、pkg-config 等）已就位
容易被忽略的兼容性断点
很多问题卡在“看似能跑，实则埋雷”的地方：
- 虚拟环境创建时若底层 Python 是最小化安装（如某些 Linux 发行版自带的 python3-minimal），
venv不会自动带 setuptools，必须手动补：python -m pip install --upgrade setuptools - macOS 上用 Homebrew 装的 Python，
--user安装路径可能和 shell 的PYTHONPATH冲突，优先用python -m pip install --user而非pip install --user - Windows 下 cmd 和 PowerShell 对路径空格、反斜杠的处理差异，导致 setup.py 找不到依赖文件；统一用
python -m pip前缀可规避解释器查找歧义
