mac uv 使用

目录

• • uv安装
• 生成空项目
• 使用
  • 激活虚拟环境
  • 退出虚拟环境
  • 查看虚拟环境安装的库的版本
  • 从 uv.lock安装
  • uv测试包安装
  • 安装包
  • 方法1
  • 方法2
  • 激活环境（新建一个mac窗口）
  • 导出虚拟环境依赖，安装依赖清单
  • uv.lock依赖的文件导到./dependency_lib 目录
• 创建目标目录
• 使用uv安装依赖到指定目录（不影响当前虚拟环境）
• 因网络不稳定，安装失败处理
  • 如果uv安装报网络错误，用 pip install可以成功，可以试着用下载到本地，从本地安装
• 参考资料

【切记】安装命令必须是 uv前缀

uv安装

# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh

# On Windows.
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# With pip.
pip install uv

# With pipx.
pipx install uv

# With Homebrew.
brew install uv

# With Pacman.
pacman -S uv

For Linux and macOS, modify the PATH environment variable using the following command in the terminal:

export PATH="$HOME/.local/bin:$PATH"

生成空项目

uv init sample-project

使用

生成虚拟环境
进入到python项目目录

uv venv
或者 制定虚拟环境名字
uv venv my-name

激活虚拟环境

source .venv/bin/activate

退出虚拟环境

deactivate

查看虚拟环境安装的库的版本

uv pip list

从 uv.lock安装

执行同步命令
使用 uv sync 命令根据 uv.lock 安装依赖并配置虚拟环境：

uv sync

• 作用：自动读取 uv.lock 中的精确依赖版本，创建/更新虚拟环境（默认位于 .venv），并安装所有依赖。
• 虚拟环境：若 .venv 不存在，uv 会自动创建；若已存在，会更新至锁文件状态。

uv测试包安装

uv sync --group test

安装包

uv pip install flask                # Install Flask.
uv pip install -r requirements.txt  # Install from a requirements.txt file.
uv pip install -e .                 # Install current project in editable mode.
uv pip install "package @ ."        # Install current project from disk
uv pip install "flask[dotenv]"      # Install Flask with "dotenv" extra.

安装包

方法1

uv pip install -U langgraph

注意：

不能使用 pip install -U langgraph，否则不会安装到虚拟环境！！

方法2

uv add llama-index llama-index-llms-openai-like

uv add dotenv

安装指定版本的包，如有先删除再安装
uv pip install numpy==1.26.4

激活环境（新建一个mac窗口）

source /absolute/path/to/venv/bin/activate # 例如：/Users/yourname/envs/myenv/bin/activate

导出虚拟环境依赖，安装依赖清单

uv pip list > requirements.txt
uv pip install -r requirements.txt

uv.lock依赖的文件导到./dependency_lib 目录

创建目标目录

mkdir -p ./dependency_lib

uv export --format requirements-txt --output-file requirements.txt

使用uv安装依赖到指定目录（不影响当前虚拟环境）

uv pip install --no-deps --target ./dependency_lib -r requirements.txt

因网络不稳定，安装失败处理

如果uv安装报网络错误，用 pip install可以成功，可以试着用下载到本地，从本地安装

pip download llama-index sentence-transformers transformers -d ./packages
uv pip install --no-index --find-links=./packages llama-index sentence-transformers transformers

参考资料

llm封装
https://docs.llamaindex.ai/en/stable/api_reference/llms/openai_like/

https://codemaker2016.medium.com/introducing-uv-next-gen-python-package-manager-b78ad39c95d7#a488