调研探索
uv/pip 依赖安装异常时,先核查实际 Python…
当 `uv sync` 或 `pip install` 行为异常、可选依赖被跳过或 import 失败时,用来定位并修复解释器版本不匹配问题。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 49/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 85/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
uv/pip 依赖安装异常时,先核查实际通用
解决思路
- 检查 uv 实际使用的解释器版本:运行 `uv run python --version`
- 查看被固定的版本(它控制 uv 的行为):运行 `cat .python-version`
- 确认包是否真的安装成功:运行 `uv pip show <package>`
- 确认在该 uv 上下文中能正常导入:运行 `uv run python -c "import <package>; print(<package>.__version__)"`
- 若可选依赖要求 Python 3.12+ 而 `.python-version` 是 3.11,则改写版本并重建环境:先 `echo "3.13" > .python-version`,再 `rm -rf .venv && uv venv && uv sync --all-extras`
适用边界 · 注意事项
- 不要在使用 uv 时信任 `python3 --version` 的输出,它可能指向系统 Python 而非 uv 选用的解释器
- 不要在未验证 import 的情况下就假定安装已成功
- 不要在检查解释器版本之前就继续深入调试其他方向