Python环境排查与修复指南：解决uv/pip安装异常、解释器版本冲突问题
environment-triage by parcadei/continuous-claude-v3
安装命令
npx skills add https://github.com/parcadei/continuous-claude-v3 --skill environment-triage🇨🇳中文介绍
环境排查
当 uv sync 或 pip install 行为异常时，请检查实际使用的解释器。
模式
如果 uv/venv 选择了不同的解释器，那么系统 Python 就不是权威的。
应做事项
# 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 - 未经确认导入就假设安装成功
- 在检查解释器版本之前进行进一步调试
来源会话
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
