跳转至

uv remove

从项目中移除依赖项。

依赖项将从项目的 pyproject.toml 文件中移除。

如果给定依赖项存在多个条目(例如,每个条目具有不同的标记),所有条目都将被移除。

锁文件和项目环境将更新以反映移除的依赖项。要跳过更新锁文件,请使用 --frozen。要跳过更新环境,请使用 --no-sync

如果请求的任何依赖项在项目中不存在,uv 将退出并报错。

如果包已在环境中手动安装(例如,使用 uv pip install),它不会被 uv remove 移除。

uv 将在当前目录或任何父目录中搜索项目。如果找不到项目,uv 将退出并报错。

Usage

uv remove [OPTIONS] <PACKAGES>...

Arguments

<PACKAGES>...

要移除的依赖项名称(例如,ruff

Options

--dev

从开发依赖组中移除包

--optional

从项目的指定额外依赖的可选依赖项中移除包

--group

从指定的依赖组中移除包

--no-sync

在重新锁定项目后避免同步虚拟环境 [env: UV_NO_SYNC=]

--active

优先使用活动虚拟环境而不是项目的虚拟环境

--locked

断言 uv.lock 将保持不变 [env: UV_LOCKED=]

--frozen

在不重新锁定项目的情况下移除依赖项 [env: UV_FROZEN=]

--package

从工作区中的特定包移除依赖项

--script

从指定的 Python 脚本而不是项目中移除依赖项

Index options

--index

除了默认索引之外,用于解析依赖项的 URL [env: UV_INDEX=]

--default-index

默认包索引的 URL(默认:https://pypi.org/simple)[env: UV_DEFAULT_INDEX=]

-i, --index-url

(已弃用:请使用 --default-index)Python 包索引的 URL(默认:https://pypi.org/simple)[env: UV_INDEX_URL=]

--extra-index-url

(已弃用:请使用 --index)除了 --index-url 之外要使用的包索引的额外 URL [env: UV_EXTRA_INDEX_URL=]

除了在注册表索引中找到的位置之外,搜索候选分发的位置 [env: UV_FIND_LINKS=]

--no-index

忽略注册表索引(例如,PyPI),而是依赖直接 URL 依赖项和通过 --find-links 提供的依赖项

--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]

Resolver options

-U, --upgrade

允许包升级,忽略任何现有输出文件中的固定版本。暗示 --refresh

-P, --upgrade-package

允许特定包的升级,忽略任何现有输出文件中的固定版本。暗示 --refresh-package

--resolution

在为给定包需求选择不同兼容版本时使用的策略 [env: UV_RESOLUTION=] [可能的值:highest, lowest, lowest-direct]

--prerelease

考虑预发布版本时使用的策略 [env: UV_PRERELEASE=] [可能的值:disallow, allow, if-necessary, explicit, if-necessary-or-explicit]

--fork-strategy

在跨 Python 版本和平台选择给定包的多个版本时使用的策略 [env: UV_FORK_STRATEGY=] [可能的值:fewest, requires-python]

--exclude-newer

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

--no-sources

在解析依赖项时忽略 tool.uv.sources 表。用于锁定符合标准的、可发布的包元数据,而不是使用任何工作区、Git、URL 或本地路径源

Installer options

--reinstall

重新安装所有包,无论它们是否已安装。暗示 --refresh

--reinstall-package

重新安装特定包,无论它是否已安装。暗示 --refresh-package

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

--compile-bytecode

安装后将 Python 文件编译为字节码 [env: UV_COMPILE_BYTECODE=]

Build options

-C, --config-setting

传递给 PEP 517 构建后端的设置,指定为 KEY=VALUE

--no-build-isolation

构建源分发时禁用隔离 [env: UV_NO_BUILD_ISOLATION=]

--no-build-isolation-package

为特定包构建源分发时禁用隔离

--no-build

不构建源分发 [env: UV_NO_BUILD=]

--no-build-package

不为特定包构建源分发 [env: UV_NO_BUILD_PACKAGE=]

--no-binary

不安装预构建的 wheel [env: UV_NO_BINARY=]

--no-binary-package

不为特定包安装预构建的 wheel [env: UV_NO_BINARY_PACKAGE=]

Cache options

-n, --no-cache

避免读取或写入缓存,而是在操作期间使用临时目录 [env: UV_NO_CACHE=]

--cache-dir

缓存目录的路径 [env: UV_CACHE_DIR=]

--refresh

刷新所有缓存数据

--refresh-package

刷新特定包的缓存数据

Python options

-p, --python

用于解析和同步的 Python 解释器。[env: UV_PYTHON=]

--managed-python

要求使用 uv 管理的 Python 版本 [env: UV_MANAGED_PYTHON=]

--no-managed-python

禁用 uv 管理的 Python 版本 [env: UV_NO_MANAGED_PYTHON=]

--no-python-downloads

禁用 Python 的自动下载。[env: "UV_PYTHON_DOWNLOADS=never"]

Global options

-q, --quiet...

使用静默输出

-v, --verbose...

使用详细输出

--color

控制输出中颜色的使用 [可能的值:auto, always, never]

--native-tls

是否从平台的本机证书存储加载 TLS 证书 [env: UV_NATIVE_TLS=]

--offline

禁用网络访问 [env: UV_OFFLINE=]

--allow-insecure-host

允许与主机的不安全连接 [env: UV_INSECURE_HOST=]

--no-progress

隐藏所有进度输出 [env: UV_NO_PROGRESS=]

--directory

在运行命令之前切换到给定目录

--project

在给定项目目录中运行命令 [env: UV_PROJECT=]

--config-file

用于配置的 uv.toml 文件路径 [env: UV_CONFIG_FILE=]

--no-config

避免发现配置文件(pyproject.tomluv.toml)[env: UV_NO_CONFIG=]

-h, --help

显示此命令的简洁帮助