uv能直接替代pip+venv+pip-tools组合，但需注意默认不自动激活环境、不自动读取requirements.txt等细节，否则易出现“装了却import不到”等问题。
uv 能直接替代 pip + venv + pip-tools 的组合，但不是“装完就能无脑用”——它默认不自动激活虚拟环境，也不默认读取 requirements.txt，这些细节不注意，你会以为它“没反应”或“装了包却 import 不到”。
安装后命令找不到？检查 PATH 和终端重启
Windows 上用 PowerShell 脚本安装后，uv 命令在当前窗口不可用是常态；macOS/Linux 用 curl 安装后，shell 配置文件（如 ~/.zshrc）可能没重载。这不是 uv 故障，而是环境变量未生效。
- Windows：关掉当前 PowerShell，新开一个，再运行
uv --version - macOS/Linux：运行
source ~/.zshrc（或~/.bash_profile），再试；如果仍不行，检查脚本是否把 bin 路径加到了$PATH里（通常加在~/Library/Application Support/uv/bin或$HOME/.local/bin） - 通用验证方式：
which uv（macOS/Linux）或Get-Command uv（PowerShell）能返回路径才算真正就位
初始化项目时 Python 版本不存在？uv 会自动下载，但需联网且允许后台操作
执行 uv init --python 3.13 时若报错 Python version 3.13 not found，不是命令写错了，而是 uv 尚未缓存该版本。它不会静默失败，而是明确提示可下载项——你只需再跑一次相同命令，或先手动触发安装：
- 先查可用版本：
uv python list（注意输出中带<download available>的条目） - 手动安装：
uv python install 3.13，完成后uv init --python 3.13就能立刻创建环境 - 关键点：uv 默认不自动下载缺失 Python，除非你在
uv venv或uv init中显式指定版本且本地无对应二进制——这时它才发起后台下载，整个过程无进度条，容易误判为卡死
添加依赖后 import 报错？确认是否在正确环境中执行
uv 创建的虚拟环境（如 .venv）不会自动激活，uv add requests 是往当前项目关联的虚拟环境中装包，但如果你用系统 Python 或其他解释器运行脚本，自然找不到 requests。
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
立即学习“Python免费学习笔记（深入）”；
- 最简验证方式：
uv run python -c "import requests; print(requests.__version__)"—— 这条命令强制使用项目环境里的 Python - 不要依赖
source .venv/bin/activate，uv 的设计哲学是“环境感知”，即多数命令（uv run、uv pip install）自动桥接，但普通python命令不会 - PyCharm 等 IDE 需手动指向
.venv/bin/python（macOS/Linux）或.venv\Scripts\python.exe（Windows），不能只选“uv”作为工具链
uv.lock 文件生成时机与手动触发条件
uv.lock 不是每次 uv add 后自动生成，它只在明确需要确定性解析时才写入——比如首次 uv add、或运行 uv pip compile。如果你删了它，uv add 仍能工作，但后续 uv pip sync 会失败。
- 首次添加依赖后，
uv.lock会自动创建；之后每次uv add或uv remove都会更新它 - 想从
pyproject.toml重新生成锁文件：uv pip compile pyproject.toml -o uv.lock - 重要限制：uv 目前不支持像
pip-tools那样用in/txt分离源文件和锁文件；uv.lock是唯一权威锁定依据，别删，也别手改
最容易被忽略的是：uv 的“自动”是有条件的——它只在明确上下文（项目目录、存在 pyproject.toml、指定了 --python）下才触发环境绑定和依赖隔离。在空目录随便敲 uv add，它会装到全局 site-packages，而不是你预期的项目环境里。
