VSCode中Jupyter Notebook内核无法保留默认设置的恢复求助

问题概述 #

此前在VSCode中可正常运行Jupyter Notebook，尝试用旧Python版本运行含弃用命令的旧Notebook后，切换回Python 3.11时出现以下问题：

• 需手动通过命令面板选择内核
• 内核名称持续加载（转圈）
• 运行第一个单元格报错
• 终端执行pip3 install ipykernel显示依赖已满足

恢复步骤 #

• 清理VSCode与Jupyter缓存

  1. 完全关闭VSCode
  2. 删除VSCode工作区缓存：
     • Windows：删除%APPDATA%\Code\User\workspaceStorage下的所有内容
     • macOS：删除~/Library/Application Support/Code/User/workspaceStorage下的所有内容
     • Linux：删除~/.config/Code/User/workspaceStorage下的所有内容
  3. 删除Jupyter运行时缓存：
     • Windows：%APPDATA%\jupyter\runtime
     • macOS/Linux：~/.local/share/jupyter/runtime

• 重置VSCode的Jupyter扩展配置

  1. 打开VSCode，按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）唤出命令面板
  2. 输入Preferences: Open Settings (JSON)并打开设置文件
  3. 搜索所有包含jupyter的配置项，删除这些自定义配置（保留默认设置），保存后重启VSCode

• 重新注册Python 3.11内核

  1. 打开终端，确保当前环境指向Python 3.11（虚拟环境需先激活）
  2. 执行命令升级ipykernel：python3.11 -m pip install --upgrade ipykernel
  3. 重新注册内核：python3.11 -m ipykernel install --user --name "python3.11" --display-name "Python 3.11"

• 清除Notebook的本地内核关联

  1. 打开有问题的Notebook，点击右上角内核选择器，选择Select Another Kernel
  2. 在列表中选中Python 3.11，保存Notebook
  3. 若问题仍存在，删除Notebook同目录下的.ipynb_checkpoints文件夹，重新打开Notebook

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