跳转至

4.uv使用记录

使用步骤

  • 将项目git到本地

  • uv venv新建虚拟环境，无需激活，直接安装依赖：uv pip install -r requirements.txt

    • uv默认将依赖安装到虚拟环境，若无虚拟环境则报错，或添加--system安装到全局
    • 安装后可通过uv pip show <package>查看依赖位置（此时虚拟环境未激活，pip show <package>识别不到包）

  • .venv\Scripts\activate：激活venv

查看当前环境的安装路径

​方法 1：通过 Python 命令

运行以下命令查看所有包路径：

python -m site

输出示例：

sys.path = [
    '/usr/local/lib/python3.11/site-packages',  # 全局路径
    '/home/user/.local/lib/python3.11/site-packages',  # 用户路径
]

​方法 2：使用 sysconfig 模块

python -c "import sysconfig; print(sysconfig.get_path('purelib'))"

这会直接打印全局包的安装路径（如 /usr/local/lib/python3.11/site-packages）。

基础使用

​命令​ ​层级​ ​核心用途​
uvx 全局工具 运行独立应用，隔离环境
uv add 项目依赖 自动化管理本地依赖和配置文件
uv pip 底层包操作 直接执行 pip 风格的命令

安装和管理 Python 版本

  • uv python install 3.11：安装 Python 3.11版本。
  • uv python list：查看可用的 Python 版本。

  • uv python find：查找已安装的 Python 版本。

  • uv python pin：为当前项目指定使用的 Python 版本。

  • uv python uninstall：卸载 Python 版本。

项目

创建并管理包含 pyproject.toml 的 Python 项目。

  • uv init：创建一个新项目。
  • uv add：向项目添加依赖。

  • uv remove：从项目中移除依赖。

  • uv run：在项目环境中运行命令。

  • uv tree：查看项目的依赖树。