VS Code Jupyter导入自定义模块报无法解析错误解决方案

这个问题本质是Pylance静态代码扫描的路径逻辑和Jupyter运行时的路径逻辑不一致：Jupyter运行单元格时会自动把当前笔记本所在目录加入运行时路径，所以代码执行不会报错；但Pylance做静态检查时不会自动读取运行时的sys.path，第三方包因为装在Python解释器的site-packages目录下能被扫到，普通.py文件会默认读取工作区根目录作为扫描路径也不会报错，唯独Jupyter场景下自定义模块的路径识别容易出问题。你之前配的相对路径extraPaths在Jupyter场景下识别率极低，按下面步骤操作就能解决：

• 首先确认VS Code打开的工作区根目录正确：直接选中AIInvestmentProject文件夹作为工作区打开，不要打开它的上一级目录，否则相对路径匹配会直接错位。
• 把settings.json里的python.analysis.extraPaths配置从相对路径改成绝对路径，不要用./开头的写法。比如你的项目存放在/Users/xxx/code/AIInvestmentProject（Mac/Linux）或者E:/code/AIInvestmentProject（Windows），配置改成如下格式即可，不需要单独加models子目录：

"python.analysis.extraPaths": [
    "E:/code/AIInvestmentProject"
]

改完按Ctrl+Shift+P（Mac是Cmd+Shift+P）调出命令面板，执行Reload Window重载窗口，大部分场景下这一步就能消除提示。

• 如果重载后提示还在，检查Jupyter内核选择是否正确：点击笔记本右上角的内核选择按钮，确认选中的内核和你项目使用的Python解释器完全一致——Jupyter场景下Pylance的静态检查是跟着选中的内核走的，不是跟着VS Code左下角选的全局Python解释器走的，内核选错了路径配置再对也没用。
• 临时快速修复可以直接在笔记本第一个单元格加入路径注入代码，执行一次后Pylance也能识别到对应路径：

import sys
# 替换成你自己的项目根目录绝对路径
sys.path.append("E:/code/AIInvestmentProject")

不建议直接在配置里全局关闭reportMissingImports检查，会把真正的导包错误提示一起屏蔽，后续写代码容易踩坑。

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