pip安装的Python打包程序如何配置为Linux命令行独立客户端运行

1. 新增命令行入口逻辑 #

在你的Python包目录下新增入口脚本，比如你的包名为myclient，新建myclient/cli.py文件，写入命令行解析和业务触发逻辑，示例如下：

import argparse

def main():
    # 定义主命令解析器
    parser = argparse.ArgumentParser(description="自定义客户端工具")
    # 定义子命令集合
    subparsers = parser.add_subparsers(dest="command", required=True)
    
    # 配置start子命令，支持额外参数
    start_parser = subparsers.add_parser("start", help="启动客户端服务")
    start_parser.add_argument("--port", type=int, default=8000, help="服务监听端口")
    
    # 可继续添加其他子命令，比如train、test等
    # train_parser = subparsers.add_parser("train", help="训练模型")

    args = parser.parse_args()
    
    # 按命令触发对应业务逻辑
    if args.command == "start":
        # 此处替换为你原本的启动逻辑
        print(f"客户端正在启动，监听端口{args.port}")

2. 修改打包配置文件，新增命令行入口映射 #

根据你打包时用的配置文件选择对应修改方案：

方案A：使用setup.py打包 #

在setup()函数中添加entry_points配置：

from setuptools import setup, find_packages

setup(
    name="myclient",
    version="0.1.0",
    packages=find_packages(),
    # 核心配置：命令行入口映射
    entry_points={
        'console_scripts': [
            # 等号左边是自定义命令名，右边是「入口模块:入口函数」
            'mycli = myclient.cli:main',
        ]
    },
    # 其余你原有配置（依赖、作者信息等）保留即可
)

方案B：使用pyproject.toml打包（Python官方推荐方式） #

在配置文件中添加如下字段：

[project.scripts]
mycli = "myclient.cli:main"

3. 重新打包安装测试 #

• 清理旧打包缓存，重新生成whl文件：python -m build
• 卸载之前安装的旧版本包：pip uninstall -y myclient
• 安装新生成的whl文件：pip install dist/myclient-0.1.0-py3-none-any.whl
• 直接输入mycli start即可触发启动逻辑，和Rasa的调用逻辑完全一致

异常排查 #

如果输入自定义命令提示找不到指令，检查pip安装的可执行文件目录是否在系统PATH中：

• 普通用户pip默认安装路径为~/.local/bin，root用户为/usr/local/bin
• 临时生效可执行：export PATH=$PATH:~/.local/bin
• 永久生效可将上述命令写入~/.bashrc或~/.zshrc配置文件

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