用途:帮助开发者在由 Pixi 管理的 Python 项目中使用这一基于 conda 的包管理器,管理 conda/PyPI 依赖、在隔离环境中运行命令,并配置多环境项目。当项目根目录存在 pixi.toml 或 pixi.lock 时适用。
主要能力:初始化与安装(pixi init、pixi install、pixi install -e dev);添加依赖(pixi add python=3.11 pytorch pandas、pixi add --pypi transformers、pixi add --feature dev pytest ruff);运行命令与任务(pixi run python script.py、pixi run -e dev pytest、pixi shell、pixi task add/list、pixi run lint);生产运行(pixi run --frozen --no-install train.py)。常用标志包括 -e、--frozen、--no-install、--feature。
核心概念:工作区含 pixi.toml(配置,应提交)、pixi.lock(锁文件,应提交)、.pixi/(环境缓存,不应提交);环境为命名依赖集合,用 -e 选择;feature 是可组合进环境的可复用依赖组;task 是 pixi.toml 中预定义命令。配置涵盖 [project]、[dependencies]、[pypi-dependencies]、[tasks]、[feature.*.dependencies]、[environments]、[activation.env]。
用法要点:优先使用 conda 包,必要时用 --pypi;关键版本可固定;CI/生产使用 --frozen;用 solve-group 隔离或共享环境;[activation.env] 变量仅在 pixi run 或 pixi shell 内生效。
限制与排错:包找不到时检查 channels、包名或改用 PyPI;不要用裸 python 运行;锁文件冲突后可 pixi install 或删除 pixi.lock 后重装;同一包不要同时用 conda 与 PyPI。官方文档见 https://pixi.sh/latest/。