如何解决VSCode Jupyter Notebook中Pylance的‘import could not be resolved’问题？

核心问题 #

你的导入路径与实际文件结构不匹配：query_creative.py在同级的queries目录下，但代码里写的是src/query路径。虽然Python运行时通过sys.path.append('..')能找到文件，但Pylance的静态分析无法识别错误路径，因此出现提示。

解决方案 #

1. 修正导入语句

将导入代码改为匹配实际文件结构的路径：

import sys
sys.path.append('..')
from queries.query_creative import query_creative

2. 配置Pylance的源码路径

如果修正后仍有提示，在VS Code的settings.json中添加以下配置，让Pylance正确识别项目的模块搜索路径：

{
    "python.analysis.extraPaths": ["${workspaceFolder}/queries"],
    "python.analysis.sourceRoots": ["${workspaceFolder}"]
}

• python.analysis.extraPaths：指定Pylance需要额外扫描的模块路径
• python.analysis.sourceRoots：将项目根目录标记为源码根，让Pylance直接识别根目录下的文件夹作为可导入模块

3. 重启Pylance语言服务

配置修改后，执行以下操作生效：

• 按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac）
• 搜索并执行Python: Restart Language Server

内容的提问来源于stack exchange，提问作者Sanjin Juric Fot