如何调试Jupyter Notebook profile_default/startup目录下的脚本

1. 捕获启动脚本输出与日志 #

• 在启动脚本开头加入输出重定向代码，直接将脚本的所有打印信息、报错栈存到本地日志文件，示例代码：

import sys
from datetime import datetime
# 替换为你自己的本地日志路径
log_path = r"C:\Users\你的用户名\jupyter_startup.log"
sys.stdout = open(log_path, 'a', encoding='utf-8')
sys.stderr = sys.stdout
print(f"\n===== {datetime.now()} 启动脚本开始执行 =====")

启动Jupyter后直接打开上述日志文件，即可查看脚本执行的全流程输出。

• 启动Jupyter时开启debug模式，所有内核启动、脚本执行日志会直接输出在命令行：
  命令行执行：jupyter notebook --debug
  若要将日志存为本地文件，执行：jupyter notebook --debug > jupyter_full.log 2>&1，后续直接查看jupyter_full.log即可。

2. 手动调试启动脚本 #

• 打开当前Jupyter内核对应的IPython终端，逐行运行你的启动脚本代码，每步检查执行结果：
  比如先执行import keyboard确认模块导入正常，再执行热键注册代码，观察是否抛出异常。
• Windows环境下keyboard模块需要管理员权限才能正常注册全局热键，权限不足时热键会静默注册失败，你可以在脚本中加入权限校验代码：

import ctypes
is_admin = ctypes.windll.shell32.IsUserAnAdmin() != 0
print(f"当前运行权限是否为管理员：{is_admin}")
if not is_admin:
    print("错误：非管理员权限无法注册全局热键，keyboard热键功能将失效")

3. 前置配置校验 #

• 确认脚本存放路径正确：在IPython中执行ipython locate profile default，获取profile_default的实际路径，检查你的脚本是否放在该路径下的startup子文件夹中，且文件后缀为.py。
• 确认环境匹配：在启动脚本中加入print(sys.executable)，输出的Python解释器路径需要和你安装keyboard模块的环境路径一致，避免虚拟环境不匹配导致的模块导入失败。

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