管理软件包

安装软件包

要将软件包安装到虚拟环境中，例如 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 安装特定引用的软件包：

$ # 安装标签版本
$ uv pip install "git+https://github.com/astral-sh/ruff@v0.2.0"

$ # 安装提交版本
$ uv pip install "git+https://github.com/astral-sh/ruff@1fadefa67b26508cc59cf38e6130bde2243c929d"

$ # 安装分支版本
$ uv pip install "git+https://github.com/astral-sh/ruff@main"

有关从私有仓库安装的内容，请参阅 Git 认证文档。

可编辑软件包

可编辑软件包的源代码发生更改时，无需重新安装即可生效。

要将当前项目安装为可编辑软件包：

$ 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 而不是 some/path/pyproject.toml 中获取 foo。

卸载软件包

要卸载一个软件包，例如 Flask：

$ uv pip uninstall flask

要卸载多个软件包，例如 Flask 和 Ruff：

$ uv pip uninstall flask ruff