管理包

安装包

将包安装到虚拟环境中，例如 Flask

$ uv pip install flask

安装带有可选依赖项的包，例如带有 "dotenv" 扩展功能的 Flask

$ uv pip install "flask[dotenv]"

安装多个包，例如 Flask 和 Ruff

$ uv pip install flask ruff

通过约束条件安装包，例如 Ruff v0.2.0 或更高版本

$ uv pip install 'ruff>=0.2.0'

安装特定版本的包，例如 Ruff v0.3.0

$ uv pip install 'ruff==0.3.0'

从磁盘安装包

$ uv pip install "ruff @ ./projects/ruff"

从 GitHub 安装包

$ uv pip install "git+https://github.com/astral-sh/ruff"

从 GitHub 安装指定引用的包

$ # Install a tag
$ uv pip install "git+https://github.com/astral-sh/[email protected]"

$ # Install a commit
$ uv pip install "git+https://github.com/astral-sh/ruff@1fadefa67b26508cc59cf38e6130bde2243c929d"

$ # Install a branch
$ uv pip install "git+https://github.com/astral-sh/ruff@main"

请参阅 Git 身份验证文档以了解如何从私有仓库安装。

可编辑安装（Editable packages）

可编辑安装的包不需要重新安装即可使其源代码的更改生效。

将当前项目以可编辑模式安装

$ uv pip install -e .

将另一个目录中的项目以可编辑模式安装

$ uv pip install -e "ruff @ ./project/ruff"

从文件安装包

可以一次性通过标准文件格式安装多个包。

从 requirements.txt 文件安装

$ uv pip install -r requirements.txt

有关 requirements.txt 文件的更多信息，请参阅 uv pip compile 文档。

从 pyproject.toml 文件安装

$ uv pip install -r pyproject.toml

从带有可选依赖项的 pyproject.toml 文件安装，例如 "foo" 扩展功能

$ uv pip install -r pyproject.toml --extra foo

从启用了所有可选依赖项的 pyproject.toml 文件安装

$ uv pip install -r pyproject.toml --all-extras

安装当前项目目录 pyproject.toml 中的依赖组，例如 foo 组

$ uv pip install --group foo

指定获取依赖组的项目目录

$ uv pip install --project some/path/ --group foo --group bar

或者，您可以为每个组指定 pyproject.toml 的路径

$ uv pip install --group some/path/pyproject.toml:foo --group other/pyproject.toml:bar

注意

与 pip 一样，--group 标志不适用于通过 -r 或 -e 等标志指定的其他源。例如，uv pip install -r some/path/pyproject.toml --group foo 会从 ./pyproject.toml 获取 foo，而不是从 some/path/pyproject.toml 获取。

卸载包

卸载包，例如 Flask

$ uv pip uninstall flask

卸载多个包，例如 Flask 和 Ruff

$ uv pip uninstall flask ruff