如何使用uv在本地安装自行构建的Python软件包

方案1：绕过系统Python的外部管理限制（直接但有风险） #

如果不在意系统依赖冲突，可以用--break-system-packages参数强制全局安装：

# 安装tar.gz包
uv pip install --system --break-system-packages ./dist/foobar.tar.gz

# 或者安装wheel文件
uv pip install --system --break-system-packages ./dist/foobar-*.whl

注意：这个参数会跳过系统的包管理防护，可能导致系统Python依赖混乱，仅在必要时使用。

方案2：创建独立虚拟环境并全局链接（推荐安全方式） #

这种方法不会污染系统Python，步骤如下：

1. 为你的CLI工具创建专属虚拟环境：

uv venv ~/.venvs/foobar

2. 激活环境并安装包：

source ~/.venvs/foobar/bin/activate
uv pip install ./dist/foobar.tar.gz

3. 将CLI可执行文件链接到全局路径（替换foobar为你的工具实际命令名）：

ln -s ~/.venvs/foobar/bin/foobar /usr/local/bin/

之后就能在任何终端直接调用foobar命令了。

方案3：用系统pip直接安装（备选） #

如果系统允许，也可以跳过UV，用系统pip的用户级安装：

pip install --user --break-system-packages ./dist/foobar.tar.gz

同样，这种方式可能影响用户级依赖环境，需谨慎。

内容的提问来源于stack exchange，提问作者Eric Burel