跳转至

Pixi 基础使用#

Pixi 可以做很多事情，但设计初衷是简单易用。 让我们来了解一下 Pixi 的基础用法。

管理 workspace#

  • pixi init - 在当前目录创建新的 Pixi manifest
  • pixi add - 向 manifest 添加依赖
  • pixi remove - 从 manifest 移除依赖
  • pixi update - 更新 manifest 中的依赖
  • pixi upgrade - 将 manifest 中的依赖升级到最新版本，即使你固定到了特定版本
  • pixi lock - 为 manifest 创建或更新锁文件
  • pixi info - 显示关于 workspace 的信息
  • pixi run - 运行 manifest 中定义的任务或当前环境中的任何命令
  • pixi shell - 在当前环境中启动 shell
  • pixi list - 列出当前环境中的所有依赖
  • pixi tree - 显示当前环境中依赖的树状结构
  • pixi clean - 从你的机器上移除环境

管理全局安装#

Pixi 可以管理全局环境中的全局工具安装。 它将环境安装在一个中心位置，因此你可以从任何地方使用它们。

更多信息：全局工具

运行一次性命令#

Pixi 可以在特定环境中运行一次性命令。

例如：

> pixi exec python -VV
Python 3.13.5 | packaged by conda-forge | (main, Jun 16 2025, 08:24:05) [Clang 18.1.8 ]
> pixi exec --spec "python=3.12" python -VV
Python 3.12.11 | packaged by conda-forge | (main, Jun  4 2025, 14:38:53) [Clang 18.1.8 ]

多环境#

Pixi workspace 允许你管理多个环境。环境由一个或多个 Feature 组成。

更多信息：多环境

任务#

Pixi 可以使用其内置的任务运行器运行跨平台任务。 这可以是预定义的任务或任何普通可执行文件。

任务可以依赖其他任务。 以下是更复杂的任务用例示例

pixi.toml
[tasks]
build = "make build"
# using the toml table view
[tasks.test]
cmd = "pytest"
depends-on = ["build"]

更多信息：任务

多平台支持#

Pixi 开箱即用地支持多个平台。 你可以指定你的 workspace 支持哪些平台，Pixi 将确保依赖与这些平台兼容。

更多信息：多平台支持

实用工具#

Pixi 带有一组实用工具来帮助你调试或管理你的设置。

  • pixi info - 显示当前 workspace 和全局设置的信息
  • pixi config - 显示或编辑 Pixi 配置
  • pixi tree - 显示当前环境中依赖的树状结构
  • pixi list - 列出当前环境中的所有依赖
  • pixi clean - 从你的机器上移除 workspace 环境
  • pixi help - 显示 Pixi 命令的帮助
  • pixi help <subcommand> - 显示特定 Pixi 命令的帮助
  • pixi auth - 管理 conda channel 的认证
  • pixi search - 在配置的 channel 中搜索包
  • pixi completion - 为 Pixi 命令生成 shell 补全脚本

继续深入#

Pixi 还有更多功能待你探索。 查看左侧边栏上的主题以了解更多。

别忘了 加入我们的 Discord 来参与 Pixi 爱好者社区！