Click子命令测试失败求助：无法正常执行user子命令

我是Click新手，为保持Python环境整洁，在虚拟环境venv/lib/中安装了Click。编写了包含cli组命令与user子命令的main.py，创建shell脚本run_tool.sh激活虚拟环境并设置别名aa。执行aa可看到组命令提示，但执行aa user时仍停留在组命令界面，无法触发user子命令，尝试过设置PYTHONPATH和激活虚拟环境均无效。

问题代码 #

main.py #

import click


@click.group()
def cli():
    """This is group command."""
    pass


@click.command()
@click.option('--user', required=True, prompt='your name', help='input your name')
def user(user):
    """This is sub-group command."""
    print(f'Do something here.{user}!')

cli.add_command(user)

if __name__ == '__main__':
    cli()

run_tool.sh #

# export PYTHONPATH=$PYTHONPATH:'/Volumes/di/Temp/weixintong/wxt_DI_Learn/click_test/venv/lib'
source /Volumes/di/Temp/weixintong/wxt_DI_Learn/click_test/venv/bin/activate
# I tried both activate virtual env and export PYTHONPATH. none of them worked.
cd /Volumes/di/Temp/weixintong/wxt_DI_Learn/click_test
# python3 main.py

别名配置 #

nano ~/.zshrc
alias aa=/Volumes/di/Temp/weixintong/wxt_DI_Learn/click_test/run_tool.sh
source ~/.zshrc

执行结果 #

> aa                                                                                 at 11:59:04
Usage: main.py [OPTIONS] COMMAND [ARGS]...

  This is group command.

Options:
  --help  Show this message and exit.

Commands:
  user  This is sub-group command.

> aa user                                                                            at 11:59:06
Usage: main.py [OPTIONS] COMMAND [ARGS]...

  This is group command.

Options:
  --help  Show this message and exit.

Commands:
  user  This is sub-group command.

解决办法 #

问题出在shell脚本既没有执行Python脚本，也没有传递命令行参数。原脚本里python3 main.py被注释，就算取消注释，也没把别名执行时传入的参数（比如user）传递给main.py，导致Click始终接收不到子命令。

修改后的run_tool.sh：

source /Volumes/di/Temp/weixintong/wxt_DI_Learn/click_test/venv/bin/activate
cd /Volumes/di/Temp/weixintong/wxt_DI_Learn/click_test
python3 main.py "$@"

• $@会把执行别名时传入的所有参数（比如user、--user xxx等）完整传递给main.py，让Click能正确识别子命令并执行对应逻辑。
• 激活虚拟环境后，脚本里的python3会自动使用虚拟环境中的解释器，无需额外设置PYTHONPATH。

修改后重新执行aa user，就能正常触发user子命令的交互或参数处理流程。

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