无网络环境下在VSCode运行Python脚本及启用Interactive内核方法

排查与修复步骤 #

• 检查内核配置的网络依赖
  无网下超时基本是内核在尝试联网拉取配置或依赖。打开VSCode设置，搜索jupyter.kernels，找到Jupyter: Kernel Spec Path，去对应的本地目录（一般是~/.local/share/jupyter/kernels或conda环境下的share/jupyter/kernels）查看内核配置文件，把里面的远程地址全改成本地路径。

• 调高内核启动超时阈值
  在VSCode设置里搜jupyter.startupTimeout，默认60秒不够，改成120-180秒。对应的JSON配置是：

  "jupyter.startupTimeout": 180
  

• 确认选择的是本地内核
  别选到远程内核了。打开命令面板（Ctrl+Shift+P），输入Jupyter: Select Kernel，选Python Environments下面的本地base (Python 3.10.9)，避开带远程标识的选项。

• 清理Jupyter缓存
  无网下缓存容易出问题，删掉这些缓存目录：

  • Linux/macOS: ~/.cache/jupyter
  • Windows: %APPDATA%\jupyter\cache
    重启VSCode再试。

• 手动启动内核并连接
  要是上面的方法都没用，手动启动内核再让VSCode连：

  1. 终端激活base环境：conda activate base
  2. 启动内核：jupyter kernel --ip=127.0.0.1 --port=8888
  3. VSCode命令面板输入Jupyter: Connect to Remote Kernel，选本地的127.0.0.1:8888

无网备用方案 #

如果交互式内核死活启动不了，就用VSCode的Python: Run File in Terminal功能（右键脚本选这个），直接在终端跑脚本，虽然没有交互式的实时变量查看，但能满足无网下运行的需求。

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