uv命令行找不到是因为安装后未将二进制路径加入PATH环境变量。Mac/Linux需将对应目录（如$HOME/.local/bin）追加到~/.zshrc或~/.bashrc并重载；Windows需在系统环境变量Path中添加uv所在文件夹路径，而非uv.exe全路径。
uv 安装后为什么命令行找不到 uv
因为 uv 默认不自动修改系统 PATH，哪怕你用 curl 或 pipx 装好了，uv --version 仍会报 command not found。这不是安装失败，是路径没暴露给 shell。
Mac/Linux：把 uv 二进制所在目录加进 PATH
uv 是单文件二进制，安装位置取决于你用的方式：
- 用
curl -LsSf https://astral.sh/uv/install.sh | sh：默认装在$HOME/.local/bin/uv - 用
pipx install uv：路径类似$HOME/.local/pipx/bin/uv（具体看pipx environment --bin-dir） - 手动下载的二进制：比如你放在
/opt/uv/uv，那就用那个路径
确认路径后，在 shell 配置文件里追加一行（选对应文件）：
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc # macOS Catalina 及以后默认用 zsh # 或 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc # 旧版 macOS 或 Linux bash 用户
然后重载配置：source ~/.zshrc（或 source ~/.bashrc），再运行 which uv 应该能输出路径。
立即学习“Python免费学习笔记（深入）”；
Windows：用系统设置或 PowerShell 添加到环境变量
uv Windows 版本通常解压后是 uv.exe，你得把它所在的文件夹加进系统 PATH：
- 如果用
winget install astral-sh.uv：默认装在%LOCALAPPDATA%\Programs\astral-sh\uv，把这个完整路径加进用户或系统环境变量 - 如果手动下载并解压到
C:\tools\uv：就把C:\tools\uv加进去
添加方式：
- 图形界面：搜索“环境变量” → “编辑系统环境变量” → “环境变量…” → 在“用户变量”或“系统变量”的
Path里点“新建”，粘贴路径 → 确定 - PowerShell（需管理员权限）：
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";C:\tools\uv", "User")
新开一个 PowerShell 或 CMD 窗口，运行 uv --version 测试。
验证和常见坑
最容易漏的三件事：
- 改完
PATH没新开终端 —— 已打开的终端不会自动继承新环境变量 - 在错误的 shell 配置文件里写了路径（比如用 zsh 却只改了
.bashrc） - Windows 下加了路径但没重启终端，或者加的是带
uv.exe的完整路径（应该只加到文件夹层级，比如C:\tools\uv，不是C:\tools\uv\uv.exe）
临时验证是否生效，直接运行绝对路径试试：/home/you/.local/bin/uv --version 或 C:\tools\uv\uv.exe --version。能跑通说明二进制本身没问题，问题只在 PATH 配置。
