报错里提示 zsh: command not found: uv,说明没装 uv或装了但不在 PATH。按下面做就行(任选一种安装方式):
方式一:用 Homebrew(最省事)
bash
brew install uv
uv --version
如果 brew 也提示未找到,先装 Homebrew(可略),或确保 Apple Silicon 的 PATH 包含 /opt/homebrew/bin:
bash
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
官方文档与配方页都确认可用 brew install uv。
方式二:官方一键脚本(不依赖 Python/Rust)
bash
curl -LsSf https://astral.sh/uv/install.sh | sh
让 zsh 找到 uv(首次安装需要把 ~/.local/bin 加入 PATH)
bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
uv --version
uv 官方安装页建议用此脚本,安装位置默认在 ~/.local/bin(老版本可能在 ~/.cargo/bin)。 
方式三:用 pipx(隔离安装)
bash
python3 -m pip install --user pipx
python3 -m pipx ensurepath
pipx install uv
uv --version
官方也提供 PyPI 安装,推荐配合 pipx。
⸻
仍然 "command not found" 怎么办?
- 检查 uv 是否已经装到本地 bin:
bash
ls ~/.local/bin/uv
若能看到文件,再 echo $PATH 看是否包含 ~/.local/bin,没有就把上一段的 export PATH=... 加入 ~/.zshrc 并 source ~/.zshrc。
2. 检查 Homebrew 路径:
bash
which uv
brew --prefix
若 which uv 为空,确认 /opt/homebrew/bin 已加入 PATH(见上文)。 
⸻
在你的 conda 环境里用 uv(你现在是 (knowledge_base_service))
uv 是独立二进制,和是否激活 conda 环境无关;要把包装进当前 conda 环境,用 --python 指向当前解释器即可:
在已激活的 conda 环境中运行
bash
uv pip install --python "$(which python)" -r requirements.txt
或者安装单个包
bash
uv pip install --python "$(which python)" fastapi uvicorn
这在官方"Using environments"里明确说明,uv pip install --python /path/to/python 会把依赖装进对应解释器所在的环境。
⸻
最简上手(可选)
新项目
bash
uv init myproj && cd myproj
uv add fastapi
uv run python -c "import fastapi; print(fastapi.__version__)"