Ubuntu / WSL 安装pipx

一、安装pipx

在 Ubuntu / WSL 上可以用两种方式安装，推荐第二种（官方脚本）或第三种（pip 安装最新版本并自动配置 PATH）。

1. apt 安装（最快，但版本往往偏旧）

sudo apt update
sudo apt install pipx
# apt 默认把可执行文件装在 /usr/bin/pipx

如果只是想临时体验可以这么做，但通常 apt 源里的 pipx 版本落后，且不会帮你配置用户路径。

2. 官方一键脚本（最新版 + 自动配置）

python3 -m pip install --user pipx
python3 -m pipx ensurepath     # 把 ~/.local/bin 写进 PATH

解释：

1. --user 把 pipx 安装到 ~/.local 下，避免 sudo；

2. ensurepath 会在 ~/.bashrc、~/.zshrc 等文件尾部追加

   # added by pipx
   export PATH="$HOME/.local/bin:$PATH"

   让之后所有终端都能直接用 pipx 命令。

执行完后：

• 重新开一个终端（或 source ~/.bashrc），再试：

  pipx --version

3. 纯 pip + 手工 PATH（万一网络受限）

python3 -m pip install --user pipx
# 手动把 ~/.local/bin 加到 PATH，并重开终端
export PATH="$HOME/.local/bin:$PATH"

把上面 export 语句写进 ~/.bashrc 或 ~/.zshrc 即可。

二、使用pipx 安装 poetry 生成 pyproject.toml 文件

2.1 、Poetry（最流行的 All-in-One）

1. 安装

   pipx install poetry    

2. 在现有目录里交互式生成

   poetry init             # 逐步问答，最后生成 pyproject.toml

   • 新项目直接 poetry new --src mypkg，骨架（src 目录、tests、pyproject）一次到位。

3. 后续操作

   # 安装依赖
   poetry add fastapi
   ...
   
   # poetry install          # 创建虚拟环境并安装依赖
   # poetry build            # 打包 wheel / sdist

────────────────────────────

二、Hatch（官方推荐的新一代工具）

1. 安装

   pipx install hatch

2. 生成项目模板

   hatch new mypkg

   会得到：

   mypkg/
     ├─ src/mypkg/__init__.py
     ├─ tests/
     └─ pyproject.toml      ← 已写好 build-system + project 字段

3. 依赖管理

   cd mypkg
   hatch env create
   hatch run +dev:pytest
   hatch build