pipx

在隔离环境中安装 Python 命令行应用

补充说明

pipx 为每个命令行工具创建独立虚拟环境，再把可执行文件链接到 ~/.local/bin。它适合安装 black、ruff、poetry 这类“应用”，不适合安装供代码导入的库。

常用示例

pipx install ruff
pipx install --include-deps poetry
pipx run cowsay hello
pipx list
pipx upgrade ruff
pipx upgrade-all
pipx uninstall ruff
pipx inject ruff pytest
pipx ensurepath
pipx environment

易错点与排错

• 库（用于 import）应该用 pip/uv 装进项目环境；pipx 装进去也无法被项目导入。
• pipx run 是临时环境，每次可能拉取新版本；需要固定就用 pipx install。
• ~/.local/bin 不在 PATH 时命令找不到；运行 pipx ensurepath 并重开 shell。
• 不同应用可能依赖不同 Python 版本；用 --python 指定解释器。
• --include-deps 会把依赖也暴露为命令，可能产生命名冲突。
• pipx 环境在用户目录；多用户机器要确认每个用户各自安装。
• 升级 Python 大版本后，旧 pipx 环境可能需要重装。
• 私有包索引和认证仍走 pip 配置；不要在命令里硬编码密码。

相关命令

• pip — 安装 Python 库
• uv — 也可用 uv tool 管理命令行工具
• python — 解释器