如何让CPython对自定义常量条件的调试代码进行编译期移除优化

嘿，我完全懂你的需求——不想依赖__debug__或者繁琐的注释开关，自己定义一个调试变量，关闭时让那些耗时的调试代码直接在编译阶段就被剔除，完全不影响运行效率对吧？

其实你当前的写法已经接近目标了，只要满足一个小条件，CPython就会自动帮你把调试代码从字节码里移除：确保你的_verbose_debugging是模块级的字面量常量，并且在定义后没有被修改。

举个例子，你在模块开头写：

_verbose_debugging = False  # 直接赋值字面量，后续不修改这个变量

if _verbose_debugging:
    print("something resource intensive")

CPython的字节码编译器会自动识别出这个if条件是永远为False的常量表达式，直接跳过这段代码的编译——你可以用dis模块验证这一点：

import dis
dis.dis(你的模块名)

你会发现print相关的字节码根本不存在，和__debug__的优化效果完全一致。

如果需要更灵活的控制（比如通过命令行参数或环境变量来开关调试，同时保留编译期优化），可以用下面的技巧：

• 利用环境变量在模块加载前确定常量值，并且把它定义为字面量（这里需要确保值在编译时就能确定）：

# 在模块最开头定义
import os
# 把环境变量的值转换成字面量常量
_VERBOSE_DEBUG = os.getenv("VERBOSE_DEBUG", "0") == "1"

# 之后的调试代码
if _VERBOSE_DEBUG:
    print("resource-heavy debug log")

不过这里要注意：如果_VERBOSE_DEBUG的取值是运行时才能确定的（比如依赖其他运行时计算的值），编译器就无法做死代码消除了。所以最好让这个常量的取值是编译阶段就能确定的静态值。

另外，如果你需要完全手动控制编译期的条件，还可以用简单的预处理脚本（比如用Python自己写个小脚本），在运行前把代码里的_verbose_debugging替换成True或False，这样编译器肯定能识别并优化掉无用代码。

总结一下：

• 最简单的方式：直接定义模块级的字面量常量_verbose_debugging = False，后续不修改它，CPython会自动优化掉对应的调试代码块。
• 更灵活的方式：用环境变量/命令行参数提前确定常量值，确保它是编译时可确定的静态值，同样能触发编译期优化。

备注：内容来源于stack exchange，提问作者Clara Höfner