pipx install 将 CLI 工具安装到独立虚拟环境（Linux/macOS：~/.local/pipx/venvs/；Windows：%LOCALAPPDATA%\pipx\venvs\），主命令软链接至 ~/.local/bin/ 或 %LOCALAPPDATA%\pipx\bin\，确保全局可用且互不干扰。
pipx install 会把工具装到哪？
pipx 不会把 CLI 工具装进当前 Python 环境的 site-packages，而是为每个工具创建隔离的虚拟环境，存放在 ~/.local/pipx/venvs/（Linux/macOS）或 %LOCALAPPDATA%\pipx\venvs\（Windows）。主命令二进制文件则软链接到 ~/.local/bin/（或 Windows 的 %LOCALAPPDATA%\pipx\bin\），确保全局可执行但互不干扰。
这意味着：
– 即使你用 python -m venv myenv 激活了某个项目环境，black 或 httpx 这类 pipx 安装的命令依然可用；
– 不同工具之间不会因依赖版本冲突而报错（比如一个用 click 7.x，另一个用 click 8.x）；
– 卸载时 pipx uninstall black 会连虚拟环境一起删干净，不留残余。
哪些 CLI 工具适合用 pipx 装？
适合 pipx 的是「以命令行为主、不深度嵌入项目代码、不需要和项目依赖共存」的工具。典型包括：
-
black、isort、pylint：格式化/检查类，独立调用即可 -
httpx、ripgrep（如果用pipx install rg包装版）、todo-txt-python：纯 CLI，无 Python 项目耦合 -
poetry、pip-tools：虽然本身也参与开发流程，但作为顶层工具运行，不建议塞进项目venv - 避免用 pipx 装
django、flask、numpy：它们是库，需被 import，不是拿来直接敲命令的
pipx run 和 pipx install 有什么区别？
pipx run 是一次性运行，不安装、不保留环境；pipx install 是永久安装，带命令注册和升级能力。
立即学习“Python免费学习笔记（深入）”；
常见使用场景：
- 临时试用新工具：
pipx run --spec uvicorn uvicorn --version（不用装就跑） - 运行特定版本：
pipx run --spec "httpx==0.25.0" httpx https://httpbin.org/get - 需要频繁调用或加 shell alias：必须
pipx install httpx，否则每次都要写完整pipx run命令 -
pipx run默认不缓存环境，重复运行相同--spec会重建虚拟环境（慢），可用--include-deps或提前pipx install避免
遇到 “command not found” 或 “failed to create process” 怎么办？
这是 pipx 最常卡住的两个点，本质是 PATH 未生效或 Windows 权限问题：
- Linux/macOS：确认
~/.local/bin在$PATH中，没加的话在~/.bashrc或~/.zshrc末尾加export PATH="$HOME/.local/bin:$PATH"，然后source ~/.zshrc - Windows（CMD/PowerShell）：pipx 默认把 bin 放在
%LOCALAPPDATA%\pipx\bin，需手动加入系统或用户 PATH；用 PowerShell 运行[Environment]::SetEnvironmentVariable('Path', $env:Path + ';%LOCALAPPDATA%\pipx\bin', 'User')后重启终端 - Windows 报 “failed to create process”：通常是杀毒软件拦截了 pipx 生成的 wrapper 脚本，尝试关闭实时防护，或改用
pipx install --force --python python3.11 xxx指定明确 Python 解释器路径 - 已安装但命令找不到？运行
pipx list看是否真在列表里，再查pipx environment输出的BIN_DIR路径是否在 PATH 中
PATH 问题比依赖冲突更常见，别急着重装 pipx，先盯住这个路径链。
