Python自定义调试函数发布时完全禁用方案问询（Blender插件开发场景）

针对你在Blender插件开发中遇到的这个问题，其实有几个非常实用的方案，能帮你在发布版本时彻底禁用调试函数，甚至让Python解释器在字节码生成阶段就跳过这些调用——完全符合你的需求，而且不需要你控制编译流程，适配Blender的Python环境。

方案1：利用Python原生的__debug__常量（最推荐） #

Python有个内置的__debug__常量，当你用优化模式（-O参数）启动解释器时，它会被设为False，而且Python会在字节码生成阶段直接移除所有if __debug__:包裹的代码块——连函数调用的字节码都不会存在，彻底零开销。

Blender支持通过启动参数开启Python优化模式，只需要在启动Blender时加上--python-optimize（或者简写-O）。

具体用法： #

1. 定义你的调试函数：

def debug_log(message):
    print(f"[DEBUG] {message}")

def debug_inspect_blender_obj(obj):
    print(f"[DEBUG] Object: {obj.name}, Type: {type(obj)}")

2. 调用调试函数时，用if __debug__:包裹：

# 正常业务代码
bpy.ops.mesh.primitive_cube_add()
cube = bpy.context.active_object

# 仅在开发阶段执行的调试代码
if __debug__:
    debug_log("Cube created successfully")
    debug_inspect_blender_obj(cube)

当你用blender --python-optimize your_plugin.py启动时，__debug__为False，上面的调试代码块会被Python直接从字节码中剔除，完全不会执行，也不会有任何性能损耗。

如果你觉得每次加if __debug__:麻烦，可以写个装饰器简化：

def debug_only(func):
    if not __debug__:
        def no_op(*args, **kwargs):
            pass
        return no_op
    return func

@debug_only
def debug_log(message):
    print(f"[DEBUG] {message}")

# 调用时直接写，不用加if
debug_log("This won't run in release mode")

这种方式下，发布版本中调试函数会被替换成空函数，调用它不会有任何操作——虽然字节码里还有调用指令，但执行空函数的开销可以忽略不计。

方案2：AST语法树转换（无需依赖启动参数） #

如果你不想依赖Blender的启动参数，希望插件自己判断是否启用调试，可以用Python的ast模块在插件加载时修改代码的语法树，直接移除所有调试函数的调用。

具体实现： #

import ast
import inspect
import bpy

def remove_debug_calls(debug_func_names):
    # 定义AST转换器，移除指定调试函数的调用
    class DebugCallRemover(ast.NodeTransformer):
        def visit_Call(self, node):
            # 判断当前调用是否是调试函数
            if isinstance(node.func, ast.Name) and node.func.id in debug_func_names:
                return ast.Pass()  # 替换成空语句
            return self.generic_visit(node)

    # 获取当前插件模块的源代码
    current_module = inspect.getmodule(inspect.currentframe())
    source = inspect.getsource(current_module)
    tree = ast.parse(source)
    
    # 转换AST并重新执行模块代码
    modified_tree = DebugCallRemover().visit(tree)
    ast.fix_missing_locations(modified_tree)
    exec(compile(modified_tree, filename=inspect.getfile(current_module), mode="exec"))

# 在插件初始化时调用，指定要移除的调试函数名
def register():
    # 假设你在插件偏好设置里加了调试开关
    if not bpy.context.preferences.addons.get(__name__).preferences.debug_mode:
        remove_debug_calls(["debug_log", "debug_inspect_blender_obj"])
    # 其他注册逻辑...

这个方法会在插件加载时，自动遍历代码的语法树，把所有指定调试函数的调用替换成空语句，生成的字节码里就完全没有这些调用了——不需要依赖外部启动参数，适合发布给用户的版本。

方案3：条件导入空模块 #

还有一种更简单的方式：开发时用真实的调试模块，发布时替换成空模块。

比如你创建两个模块：

• debug_dev.py：包含真实的调试函数
• debug_release.py：所有函数都是空实现

然后在插件中这样导入：

# 根据环境判断导入哪个模块
if __debug__:
    from .debug_dev import *
else:
    from .debug_release import *

这种方式的缺点是，字节码里仍然会保留函数调用指令，只是调用的是空函数——性能影响很小，但不如前两种方案彻底。

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