Debian 12 非开发场景下Python包（Sphinx、Furo）安装最佳实践

针对你的场景（用pipx装了Sphinx但无法安装Furo，不想破坏系统包，嫌venv繁琐），推荐以下几个从优到次的方案：

方案1：用pipx inject给Sphinx注入Furo（最优解） #

pipx本身支持给已安装的隔离包添加依赖，Furo作为Sphinx的主题包，正好适合用这个方式注入到Sphinx的独立环境中，完全隔离系统Python，操作也极简：

pipx inject sphinx furo

执行后，Furo会被安装到pipx为Sphinx创建的隔离环境里，Sphinx可以直接识别并使用这个主题，既不用碰系统包，也不用额外配置，完美匹配你的需求。

方案2：启用pip用户站点安装（无需--break-system-packages） #

如果你更倾向于用pip的用户站点，Debian 12默认禁用了该功能，但可以通过配置重新启用，避免使用--break-system-packages：

1. 创建pip配置文件：

mkdir -p ~/.config/pip
cat << EOF > ~/.config/pip/pip.conf
[global]
break-system-packages = false
user = true
EOF

2. 安装Furo：

pip install furo

注意：这个方案仅当Sphinx也是通过pip install --user安装时有效，如果Sphinx是pipx装的，它的隔离环境默认不会读取用户站点的包，所以此时方案1更合适。

方案3：简化venv的使用（备选） #

如果一定要用venv，可以把环境固定在一个位置，只初始化一次，后续在钩子脚本里自动激活，并不繁琐：

1. 创建并初始化venv（仅需执行一次）：

python3 -m venv ~/.sphinx-env
source ~/.sphinx-env/bin/activate
pip install sphinx furo
deactivate

2. 在git的post-update钩子脚本中添加激活命令：

#!/bin/bash
source ~/.sphinx-env/bin/activate
# 执行你的Sphinx构建命令，比如：
# sphinx-build /path/to/source /path/to/build
deactivate

这样每次钩子触发时会自动激活venv，无需手动操作，也能保持环境隔离。

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