PEP-668后如何将自制Python包设为系统全局命令？

方法1：用户级pip安装（推荐） #

• 安装命令：pip install --user /path/to/your/package
• 原理：包会被安装到用户专属目录~/.local/lib/pythonX.Y/site-packages，可执行脚本自动放到~/.local/bin（该目录默认在用户PATH中）
• 操作后直接在终端输入脚本名即可调用，.desktop文件中直接填写脚本名称即可，无需额外配置
• 脚本shebang保持#!/usr/bin/env python3即可，无需修改

方法2：自定义全局安装目录 #

• 创建专属目录（需sudo权限）：sudo mkdir -p /usr/local/my-python-tools
• 安装包时指定前缀：sudo pip install --prefix=/usr/local/my-python-tools /path/to/your/package
• 将目录下的bin路径加入系统PATH：编辑/etc/profile或~/.profile，添加export PATH=/usr/local/my-python-tools/bin:$PATH，执行source /etc/profile（或重启终端）生效
• 脚本shebang无需修改，依赖已通过APT安装，可直接调用系统Python环境

方法3：直接部署可执行脚本 #

• 如果工具包结构简单，仅需主脚本运行：将主脚本复制到全局bin目录sudo cp /path/to/your/main-script.py /usr/local/bin/your-tool-name
• 赋予可执行权限：sudo chmod +x /usr/local/bin/your-tool-name
• 修改脚本shebang为#!/usr/bin/env python3（确保调用系统Python，依赖已通过APT安装）
• 终端直接输入your-tool-name即可调用，.desktop文件中填写/usr/local/bin/your-tool-name作为执行路径

注意事项 #

• 以上方法均符合PEP-668规范，不会破坏系统Python环境
• 用户级安装无需sudo权限，完全隔离系统环境，是最安全的方式
• 自定义全局目录需注意权限，避免系统更新时被覆盖

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