Python中如何实现类似__debug__的自定义编译时常量？

核心机制说明 #

你提到的__debug__开关效果，本质是Python编译器对这个特殊符号的两层硬编码处理：

1. 它不属于普通全局变量，编译阶段不会走模块命名空间的查找流程
2. 根据启动开关把它赋值为确定的布尔字面量后，会自动触发死代码消除，把不可能执行的分支完全从字节码中移除，最终不会留下任何运行时判断开销。

需要明确的是：目前Python没有提供原生的命令行配置选项，让普通自定义全局变量获得和__debug__完全对等的待遇。__debug__是语言规范里明确保留的特殊值，不是可以通过用户配置扩展的通用机制。

可落地的等效实现方法 #

所有能达到“编译期裁掉分支、深层循环零判断开销”效果的方案，都依托Python已有的编译规则：只要条件判断的真值在编译阶段就能被确定为固定值，编译器就会自动裁剪无用分支。常用的实现路径有两种：

• 构建阶段静态源码替换（和__debug__效果100%一致）
  这是性能敏感类Python项目最常用的方案：
  1. 在源码中用统一的全局标记作为分支判断条件，比如写if EXPERIMENTAL_FASTPATH_ENABLED:来标识实验特性开关
  2. 在项目构建、生成.pyc字节码的阶段，通过简单的文本替换脚本，根据传入的构建配置，把源码里的标记字符串直接替换成字面量True或False
  3. 替换完成后再走Python内置的编译流程生成字节码，这时候编译器会自动识别这个固定布尔值，直接删掉不需要的分支代码。最终生成的字节码里不会保留任何判断逻辑，和使用__debug__开关的效果没有区别。
     整个预替换流程只需要简单的字符串匹配，不需要引入复杂的编译器插件，几十行脚本就能实现。
• 顶层分支分流（无额外构建步骤的轻量替代）
  如果不想改动现有构建流程，可以把实验特性的判断完全放在模块顶层，把不同开关下的循环实现拆成独立函数：

  # 模块加载时就根据设置的固定值确定走哪套实现
  if EXPERIMENTAL_FASTPATH_ENABLED:
      def run_loop(iterations):
          for i in iterations:
              # 实验性快速逻辑
              do_fast_op(i)
  else:
      def run_loop(iterations):
          for i in iterations:
              # 稳定版逻辑
              do_stable_op(i)
  

  这种方式不需要额外的预编译步骤，虽然模块加载时会多一次判断，但之后所有的循环调用都不会再触发任何分支判断，基本能达到零循环开销的效果。

常见无效方案提醒 #

• 不要把typing.Final标记的常量当成编译期常量使用：Final只是给静态类型检查器的提示，Python运行时编译器不会基于这个标记做任何常量折叠或死代码消除，运行时还是会去全局命名空间查找值。
• 不要用运行时读环境变量、读配置文件的方式实现开关：这类动态获取的值是运行时计算的，编译器完全不知道最终结果，不仅不会裁剪分支，还会在深层循环里引入额外的查找和IO开销，和零损耗的目标完全相悖。

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