uv sync

更新项目的环境。同步确保所有项目依赖都已安装并与锁文件保持最新状态。

默认情况下,执行精确同步,uv 会移除未声明未项目依赖项的包。使用 --inexact 来保留无关包。如果无关包与项目依赖冲突,它仍会被移除。此外,如果使用 --no-build-isolation,uv 将不会移除无关包,以避免移除可能的构建依赖项。

如果虚拟环境(.venv)不存在,将会创建它。除非提供 -- locked 或 --frozen,否则项目会在同步前重新锁定。

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

从锁文件安装时,uv 不会为已撤回的包版本提供警告。

uv sync [OPTIONS]

--extra

包含指定额外名称的可选依赖项。

--all-extras

包含所有可选依赖项。

--no-extra

如果提供了 --all-extras,则排出指定的可选依赖项。

--no-dev

禁用开发依赖组。

--only-dev

仅包含开发依赖组。

--group

包含指定依赖组的依赖项。

--no-default-group

忽略默认依赖组。

--only-group

仅包含指定依赖组的依赖项。

--all-group

包含所有依赖组的依赖项。

--n0-editable

将任何可编辑依赖项(包括项目和任何工作区成员)安装为非可编辑 [env: UV_NO_EDITABLE=]

--inexact

不移除环境中存在的无关包。

--active

将依赖项同步到活动虚拟环境。

--no-install-project

不安装当前项目。

--no-install-workspace

不安装任何工作区成员,包括根项目。

--no-install-package

不安装给定的包。

--locked

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

--forzen

同步时不更新 uv.lock 文件 [env: UV_FROZEN=]

--dry-run

执行试运行,不写入锁文件或修改项目环境。

--all-packages

同步工作区中的所有包。

--package

同步工作区中的特定包

--scrcpt

为 Python 脚本同步环境,而不是当前项目。

--check

检查 Python 环境是否与项目同步。

最后更新于