求助：VS Code中Jupyter Notebook Kernel启动端口等待超时

1. 排查并释放端口占用 #

Jupyter默认使用8888端口，端口被占用会直接导致启动超时：

• Windows终端执行：netstat -ano | findstr :8888，找到占用端口的PID，再执行taskkill /F /PID <找到的PID>强制结束进程
• macOS/Linux终端执行：lsof -i :8888，获取PID后执行kill -9 <找到的PID>

2. 修改Jupyter端口配置 #

更换不常用端口避免冲突：

• 终端运行jupyter notebook --generate-config生成配置文件
• 打开生成的配置文件，找到c.NotebookApp.port，取消注释后改为8890这类不常用端口
• 可选：设置c.NotebookApp.open_browser = False，减少不必要的资源消耗

3. 重置ipykernel关联 #

确保当前Python环境的ipykernel正常注册：

• 在VS Code左下角状态栏切换到目标Python解释器
• 终端执行python -m ipykernel install --user，重新将当前环境注册为Jupyter内核

4. 清理VS Code缓存 #

缓存损坏可能引发异常：

• 完全关闭VS Code
• 删除对应路径的缓存文件夹：
  • Windows: %APPDATA%\Code\User\workspaceStorage
  • macOS: ~/Library/Application Support/Code/User/workspaceStorage
  • Linux: ~/.config/Code/User/workspaceStorage
• 重启VS Code后重新打开Notebook

5. 排查扩展冲突 #

部分VS Code扩展可能干扰Jupyter运行：

• 禁用除Jupyter以外的所有扩展，重启VS Code尝试启动Kernel
• 若恢复正常，再逐个启用扩展，定位冲突扩展

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