用途:当 uv sync 或 pip install 出现意外行为时,检查实际生效的解释器,定位依赖安装或导入失败的原因。
主要能力:区分系统 Python 与 uv/venv 实际选择的解释器;查看被固定的 Python 版本;确认包是否安装;验证在 uv 上下文中导入是否成功。
使用方式:用 uv run python --version 查看 uv 实际使用的版本;用 cat .python-version 查看控制 uv 的固定版本;用 uv pip show <package> 确认包已安装;用 uv run python -c "import ; print(.version)" 确认导入可用。若可选依赖需要 Python 3.12+ 而 .python-version 为 3.11,可执行 echo "3.13" > .python-version 后 rm -rf .venv && uv venv && uv sync --all-extras。
适用场景:依赖因 python_version 标记被跳过、导入失败疑似解释器不匹配等环境排查。
限制:不要在使用 uv 时信任 python3 --version;不要假设安装成功而不验证导入;不要在检查解释器版本前深入调试。资料未提供更多平台、收费或效果信息。