Debian 上 Python 依赖问题的系统化处理
一 优先使用 APT 管理依赖
- 更新索引并安装系统包：sudo apt update && sudo apt install python3-<package_name>。
- 遇到复杂依赖时，用 aptitude 替代 apt-get，它会给出多套解决策略，交互式选择更合适的解法：sudo aptitude install python3-<package_name>。
- 若已出现“未满足依赖/破损包”，先尝试修复：sudo apt -f install。
- 安装前查看包信息与已安装库：apt show python3-<package_name>；pip3 list。
- 原则：能用 Debian 仓库 提供的包，尽量用 APT 安装，减少与系统库冲突。
二 用虚拟环境隔离项目依赖
- 创建并激活虚拟环境：python3 -m venv myenv；source myenv/bin/activate。
- 在虚拟环境内使用 pip：pip install <package_name>；生成/安装依赖文件：pip freeze > requirements.txt；pip install -r requirements.txt。
- 退出环境：deactivate。
- 建议：每个项目单独一个虚拟环境，避免全局包互相影响。
三 使用现代依赖管理工具
- Poetry：适合应用与库的依赖管理、锁文件与打包发布。
安装：curl -sSL https://install.python-poetry.org | python3 -；初始化：poetry init；添加依赖：poetry add <package_name>；安装：poetry install（使用 poetry.lock 保证一致性）。
- pip-tools：适合可重复构建与“编译时锁定”依赖。
安装：pip install pip-tools；维护 requirements.in（直接依赖）→ pip-compile 生成 requirements.txt → 用 pip-sync 同步环境（精确安装/卸载到锁定状态）。
四 常见冲突场景与对策
- 系统库与 pip 包混用导致文件被占用或版本打架：优先用 APT 安装系统级包；为项目创建虚拟环境，在虚拟环境内用 pip；必要时用 pip uninstall 移除冲突的 pip 包，再让 APT 接管。
- “无法修正问题/有 held broken packages”：先 sudo apt update；再 sudo apt -f install；仍不行时改用 sudo aptitude install <package_name>，在交互方案中选择“降级/保持/替换”等策略以打破循环依赖。
- 多版本 Python 并存引发路径与模块混乱：统一使用 python3 与 pip3；为每个项目单独 venv；避免 sudo pip（易写入系统目录）。
- 需要特定版本而仓库版本过旧：优先在虚拟环境内用 pip 安装所需版本；若会影响系统组件，考虑容器化或为该应用单独准备运行环境。
