VS Code远程运行Jupyter Notebook无法导入本地模块，同服务器浏览器可正常导入

核心矛盾：VS Code远程连接运行Jupyter Notebook无法导入本地子文件夹模块，但同一服务器通过浏览器访问正常；环境变量、Python路径均一致，普通脚本/第三方库导入无异常，问题出在VS Code内核启动环节。

可能的解决步骤 #

• 临时修复：手动添加模块路径
  在Notebook的首单元格执行：

  import sys
  # 替换为你的子文件夹相对/绝对路径
  sys.path.append("./your_subfolder")
  

  测试是否能正常导入，若有效说明VS Code内核启动时未自动识别当前目录的子路径。

• 检查VS Code Jupyter内核启动配置

  1. 打开VS Code设置（Ctrl+,），搜索jupyter.runStartupCommands，查看是否存在修改sys.path的自定义命令，若有异常配置可删除。
  2. 搜索jupyter.kernelEnv，确认没有覆盖PYTHONPATH或PATH的自定义环境变量。

• 核对内核工作目录
  在Notebook中执行：

  import os
  print(os.getcwd())
  

  对比浏览器中运行的结果，若路径不一致：右键Notebook文件，选择「Set as Working Directory」，重启内核后重试。

• 重置Jupyter扩展配置

  1. 打开命令面板（Ctrl+Shift+P），输入Preferences: Open Settings (JSON)。
  2. 找到所有以jupyter.开头的配置项，备份后删除，保存设置并重启VS Code。
  3. 若无效，卸载Jupyter扩展，重启VS Code后重新安装。

• 确认Python解释器一致性
  点击VS Code左下角的Python解释器版本，确认选择的解释器与which python输出的路径完全一致，避免虚拟环境或解释器版本不匹配。

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