使用nbconvert.ExecutePreprocessor时如何禁用冻结模块调试器警告？

有效解决方案 #

1. 在脚本内部提前设置环境变量 #

这个警告来自pydev调试器，需要在导入nbconvert相关模块之前设置环境变量，确保子进程能读取到：

import os
# 禁用pydev文件验证警告
os.environ['PYDEVD_DISABLE_FILE_VALIDATION'] = '1'

import nbformat
from glob import glob
from nbconvert.preprocessors import ExecutePreprocessor

if __name__ == "__main__":
    nb_list = glob("./*.ipynb")
    ep = ExecutePreprocessor()
    for nb in nb_list:
        with open(nb) as f:
            nb_r = nbformat.read(f, as_version=4)
            ep.preprocess(nb_r)

2. 终端运行时临时设置环境变量 #

如果不想修改脚本，可以在运行脚本前先设置环境变量：

• Windows终端：

  set PYDEVD_DISABLE_FILE_VALIDATION=1 && python your_script_name.py
  

• Linux/macOS终端：

  PYDEVD_DISABLE_FILE_VALIDATION=1 python your_script_name.py
  

3. 通过VSCode任务配置（tasks.json）设置 #

如果习惯用VSCode任务运行脚本，创建或修改.vscode/tasks.json，在环境变量中添加配置：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Run Notebook Executor",
            "type": "shell",
            "command": "python your_script_name.py",
            "env": {
                "PYDEVD_DISABLE_FILE_VALIDATION": "1"
            },
            "problemMatcher": []
        }
    ]
}

为什么之前的方法无效？ #

• launch.json的配置仅对VSCode的调试会话生效，直接在终端运行脚本时不会读取这些设置；
• warnings.filterwarnings无法过滤该警告，因为它不是Python标准warnings模块输出的，而是pydev调试器的独立日志；
• 导入模块后再设置环境变量，子进程（ExecutePreprocessor运行Notebook时启动的进程）无法读取到已修改的变量。

设置PYDEVD_DISABLE_FILE_VALIDATION=1的影响 #

该变量仅关闭pydev调试器的冻结模块文件验证逻辑，不会影响脚本批量执行Notebook的功能，也不会破坏其他调试功能（仅屏蔽此特定警告）。

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