mac怎么安装uv工具

发布于:2025-09-07 ⋅ 阅读:(18) ⋅ 点赞:(0)

报错里提示 zsh: command not found: uv,说明没装 uv或装了但不在 PATH。按下面做就行(任选一种安装方式):

方式一:用 Homebrew(最省事)

brew install uv
uv --version

如果 brew 也提示未找到,先装 Homebrew(可略),或确保 Apple Silicon 的 PATH 包含 /opt/homebrew/bin:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

官方文档与配方页都确认可用 brew install uv。

方式二:官方一键脚本(不依赖 Python/Rust)

curl -LsSf https://astral.sh/uv/install.sh | sh

让 zsh 找到 uv(首次安装需要把 ~/.local/bin 加入 PATH)

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
uv --version

uv 官方安装页建议用此脚本,安装位置默认在 ~/.local/bin(老版本可能在 ~/.cargo/bin)。 

方式三:用 pipx(隔离安装)

python3 -m pip install --user pipx
python3 -m pipx ensurepath
pipx install uv
uv --version

官方也提供 PyPI 安装,推荐配合 pipx。

仍然 “command not found” 怎么办?
1. 检查 uv 是否已经装到本地 bin:

ls ~/.local/bin/uv

若能看到文件,再 echo $PATH 看是否包含 ~/.local/bin,没有就把上一段的 export PATH=… 加入 ~/.zshrc 并 source ~/.zshrc。

2.	检查 Homebrew 路径:
which uv
brew --prefix

若 which uv 为空,确认 /opt/homebrew/bin 已加入 PATH(见上文)。 

在你的 conda 环境里用 uv(你现在是 (knowledge_base_service))

uv 是独立二进制,和是否激活 conda 环境无关;要把包装进当前 conda 环境,用 --python 指向当前解释器即可:

在已激活的 conda 环境中运行

uv pip install --python "$(which python)" -r requirements.txt

或者安装单个包

uv pip install --python "$(which python)" fastapi uvicorn

这在官方“Using environments”里明确说明,uv pip install --python /path/to/python 会把依赖装进对应解释器所在的环境。

最简上手(可选)

新项目

uv init myproj && cd myproj
uv add fastapi
uv run python -c "import fastapi; print(fastapi.__version__)"

网站公告

今日签到

点亮在社区的每一天
去签到