VS Code中Jupyter Notebook无法识别工作目录的问题求助

一、快速修复核心设置 #

• 打开VS Code设置（快捷键Ctrl+,），搜索并勾选python.terminal.executeInFileDir，确保终端/交互窗口在文件所在目录启动。
• 搜索jupyter.notebookFileRoot，将其值设为${fileDirname}，强制Notebook以自身所在目录为工作根目录。

二、排查内核与环境干扰 #

• 确认Jupyter使用项目对应Python环境：点击Notebook右上角内核选择按钮，选中当前项目的虚拟环境（而非全局Python），避免路径冲突。
• 可在Notebook中执行import sys; print(sys.path)检查路径，若当前目录未在列表中，临时执行sys.path.append('./')可应急导入模块，但优先通过设置解决根本问题。

三、回退扩展版本（针对更新引发的bug） #

近期VS Code Python/Jupyter扩展的2024.6.x版本确实有大量用户反馈类似工作目录问题，属于版本兼容性bug：

• 打开扩展面板，找到Python/Jupyter扩展，点击右侧齿轮图标→「安装另一个版本」，选择之前正常的版本（如Python扩展v2024.5.1），重启VS Code后测试。

四、项目级持久化配置（推荐） #

在项目根目录创建.vscode/settings.json，添加以下配置实现项目独立设置，避免全局设置冲突：

{
    "python.terminal.executeInFileDir": true,
    "jupyter.notebookFileRoot": "${fileDirname}",
    "python.defaultInterpreterPath": "./.venv/bin/python" // 替换为你的虚拟环境路径
}

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