uv install不是合法命令，正确命令是uv pip install（安装包）或uv python install（安装Python解释器），二者功能分离、不可混用。
uv install 不是 uv 的合法命令 —— 它根本不存在。你真正想用的，是 uv pip install（包安装）或 uv python install（Python 解释器安装），两者完全不互通、不混用。
为什么敲 uv install xxx 会报错？
uv 没有顶层 install 子命令。运行 uv install requests 会直接提示：error: unrecognized subcommand 'install'。这不是拼写错误，是设计如此：uv 把「安装包」和「安装 Python」拆成两个明确路径，避免语义模糊。
常见误操作包括：
- 把 pip 的习惯套过来，以为
uv install=pip install - 看到文档里写 “uv install Python”，就照抄成
uv install 3.12，漏掉python关键字 - 在项目里执行
uv install -r requirements.txt，实际该用uv pip install -r requirements.txt
uv pip install：替代 pip 的包安装方式
这是你日常装第三方库时该用的命令，行为几乎和 pip 一致，但更快、更确定。
立即学习“Python免费学习笔记（深入）”；
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 安装单个包：
uv pip install requests - 从文件安装：
uv pip install -r requirements.txt - 带 index 镜像（如清华源）：
uv pip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests - 跳过依赖检查（慎用）：
uv pip install --no-deps numpy
注意：uv pip install 默认只作用于当前激活的虚拟环境或系统 Python —— 它不会自动创建环境。如果没提前用 uv venv 或 python -m venv 建环境，它就往你当前 Python 里装，可能污染全局。
uv python install：下载并安装 Python 解释器本身
这个命令干的是 pyenv / asdf / pyenv-win 的活，不是装包，是装 Python 二进制。
- 列出可安装版本：
uv python list（带<download available></download>的才是能装的） - 装指定版本：
uv python install 3.12.9或uv python install cpython-3.13.2-linux-x86_64-gnu - 装完后，
uv python list会显示已安装路径，比如：cpython-3.12.9-linux-x86_64-gnupy312/bin/python3.12
关键点：它不改 $PATH，也不设默认 Python。要让项目用它，得配合 uv python pin 3.12.9（生成 .python-version）或显式指定解释器路径（如 uv venv --python 3.12.9）。
容易被忽略的路径与缓存控制
uv 默认把 Python 解释器装在 $HOME/.local/share/uv/python/，缓存放在 $HOME/.cache/uv/。这两处可能撑爆小容量 SSD 或触发权限问题。
- 重定向 Python 安装位置：
UV_PYTHON_INSTALL_DIR=/path/to/my/python uv python install 3.12.9 - 重定向缓存目录：
UV_CACHE_DIR=/path/to/my/cache uv pip install requests - Windows 用户尤其要注意：不设
UV_PYTHON_INSTALL_DIR，它默认往C:\Users\XXX\AppData\Local\uv\python\写，且无提示
这些环境变量必须在运行命令前生效（export 或 PowerShell 的 $env:），不能靠改配置文件后“再试一次”——uv 不读 .uv.toml 之类的东西来覆盖路径。
