uv venv

创建虚拟环境

默认情况下,在工作目录中创建名为 .venv 的虚拟环境。可以通过位置参数提供替代路径。

如果在项目中,可以使用 UV_PROJECT_ENVIRONMENT 环境变量更改默认环境名称;这仅在从项目根目录运行时适用。

如果目标路径存在虚拟环境,它将被删除并创建一个新的虚拟环境。

使用 uv 时,虚拟环境不需要激活。uv 将在工作目录或任何父目录中查找虚拟环境。

uv venv [OPTIONS] [PATH]
  • PATH:要创建的虚拟环境的路径。

选项

选项
说明

--no-project

避免发现项目或工作区

--seed

将种子包(pipsetuptoolswheel 中的一个或多个)安装到虚拟环境中 [env: UV_VENV_SEED=]。

--allow-existing

保留目标路径上的任何现有文件或目录。

--prompt

为虚拟环境提供替代提示前缀。

--system-site-packages

让虚拟环境访问系统站点包目录

--relocatable

使虚拟环境可重定位

--index-strategy

解析多个索引 URL 时使用的策略 [env: UV_INDEX_STRATEGY=] [可能的值:first-index, unsafe-first-match, unsafe-best-match]

--keyring-provider

尝试使用 keyring 进行索引 URL 身份验证 [env: UV_KEYRING_PROVIDER=] [可能的值:disabled, subprocess]

--exclude-newer

将候选包限制为在给定日期之前上传的包 [env: UV_EXCLUDE_NEWER=]

--link-mode

从全局缓存安装包时使用的方法 [env: UV_LINK_MODE=] [可能的值:clone, copy, hardlink, symlink]

最后更新于