VSCode切换Python解释器报Flask导入、scoped_session错误如何解决

报错1：Python 3.8.2 环境提示 Unable to import 'flask' #

根因 #

当前选中的Python 3.8.2解释器对应的环境中，未安装Flask及项目相关依赖，属于环境配置缺失问题，和代码本身无关。

修复步骤 #

• 在VSCode中选中Python 3.8.2解释器后，打开内置终端，确认终端路径前缀显示的是当前3.8.2的环境路径
• 执行命令安装项目依赖：如果项目根目录存在requirements.txt文件，直接运行pip install -r requirements.txt安装所有对应版本依赖；如果没有该文件，手动安装核心依赖：pip install flask flask-login flask-sqlalchemy
• 依赖安装完成后，按Ctrl+Shift+P调出命令面板，执行Python: Restart Language Server重载Python语言服务，导入报错会自动消失。

报错2：Python 3.9.6 环境提示 Instance of 'scoped_session' has no 'add' member #

根因 #

这是Pylance/Pyright静态代码检查的误报。Flask-SQLAlchemy会动态给scoped_session注入add、delete、commit等数据库操作方法，静态分析工具无法识别这类动态注入的属性，才会抛出不存在成员的提示，代码实际运行不会触发这个错误。

修复方案（按优先级选择） #

• 方案1（推荐）：在当前3.9.6环境中安装Flask-SQLAlchemy的类型存根包，执行命令pip install flask-sqlalchemy-stubs，安装完成后重载语言服务，绝大多数场景下误报会直接消除
• 方案2：如果安装类型存根后仍有提示，可以调整Pylance的检查规则，打开VSCode的settings.json配置文件，添加如下配置项，关闭对应类型检查：

"python.analysis.diagnosticSeverityOverrides": {
    "reportOptionalMemberAccess": "none"
}

• 方案3：如果不想修改全局检查规则，可以在报错代码行的上一行添加# type: ignore注释，单独屏蔽该行的类型检查，示例：

new_note = Note(data=note, user_id=current_user.id)
# type: ignore
db.session.add(new_note)
db.session.commit()

注意：不要为了消除这个静态检查提示随意修改数据库初始化逻辑，该提示不影响代码正常运行，所有通过修改db初始化参数消提示的方案都属于冗余操作。

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