如何为pyproject.toml的console-script传递Python解释器-O/-OO参数？

运行时能否传递-O/-OO参数？ #

完全可以，两种实用方式：

• 直接用带参数的Python解释器调用生成的console脚本：
  Linux/macOS示例：

  python -O venv/bin/work
  

  Windows示例：

  python -O venv\Scripts\work.exe
  

• 跳过自动生成的脚本，直接调用目标模块的入口函数：

  python -O -m mypackage.worker_app
  

  这种方式和运行work效果完全一致，还能灵活添加各种解释器参数。

能否在pyproject.toml中固定定义这些参数？ #

标准的[project.scripts]无法直接指定Python解释器的优化参数——setuptools生成的wrapper脚本会直接调用当前激活环境的Python解释器，默认不带额外参数。

如果想固定启用-O/-OO，可以自定义启动脚本：

• Linux/macOS下创建work.sh：

  #!/bin/bash
  python -O -m mypackage.worker_app "$@"
  

• Windows下创建work.bat：

  @python -O -m mypackage.worker_app %*
  

然后在pyproject.toml中配置这个脚本作为入口：

[project.scripts]
work = "scripts/work.sh"  # 替换为脚本在项目中的实际路径

安装后，运行work就会自动以-O优化模式启动。

Console script是否始终以全调试模式运行？ #

不是，它默认使用当前Python解释器的普通模式（不带任何优化参数），并非强制全调试。你可以通过前面的方法传递参数，或者用自定义脚本固定参数，轻松切换到优化模式。

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