M2 Mac中Jupyter Notebook执行%profile魔法命令报错求助

问题背景 #

• 设备：搭载M2芯片的全新Mac，已安装Python 3.10，通过虚拟环境安装Jupyter Notebook
• 异常现象：Jupyter启动正常，可打开http://localhost:8888/tree并创建新笔记本，但执行以下命令时：

  %profile saml
  %idle_timeout 15
  

  出现错误：

  UsageError: Line magic function `%profile` not found.
  

• 对比：此前在Intel芯片Mac上按相同步骤配置，可正常执行上述命令
• 当前版本信息：

  jupyter --version
  Selected Jupyter core packages...
  IPython          : 8.14.0
  ipykernel        : 6.25.0
  ipywidgets       : 8.1.0
  jupyter_client   : 8.3.0
  jupyter_core     : 5.3.1
  jupyter_server   : 2.7.0
  jupyterlab       : 4.0.4
  nbclient         : 0.8.0
  nbconvert        : 7.7.3
  nbformat         : 5.9.2
  notebook         : 7.0.2
  qtconsole        : 5.4.3
  traitlets        : 5.9.0
  

排查与解决步骤 #

• 确认魔法命令归属：在Jupyter单元格中执行%lsmagic，查看输出列表中是否包含%profile和%idle_timeout。若不存在，说明这两个命令并非IPython原生魔法命令，依赖第三方扩展。
• 对比依赖差异：导出Intel Mac上虚拟环境的依赖列表（执行pip freeze > requirements.txt），与M2 Mac的依赖对比，找出缺失的扩展包并安装。
• 测试版本兼容性：当前Notebook版本为7.0.2，若Intel Mac使用的是6.x版本，可尝试降级Notebook：

  pip install notebook==6.5.6
  

• 同步IPython配置：复制Intel Mac上~/.ipython/profile_default/ipython_config.py中的自定义配置到M2 Mac的同路径文件，检查是否有加载扩展的配置项。
• 验证内核环境：在Jupyter页面的「内核」→「更改内核」中，确认使用的是当前虚拟环境对应的内核，避免因内核不一致导致依赖缺失。

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