Flask教程中'Import flaskr.db could not be resolved'错误修复求助

环境信息 #

• 系统：macOS Monterey 12.6.3
• 编辑器：Visual Studio Code
• 虚拟环境依赖包：

(.venv) NameMacBook-Pro:flask-tutorial name$ pip list
Package            Version
blinker            1.6.2
click              8.1.3
Flask              2.3.2
importlib-metadata 6.6.0
itsdangerous       2.1.2
Jinja2             3.1.2
MarkupSafe         2.1.2
pip                21.2.4
setuptools         58.0.4
Werkzeug           2.3.4
zipp               3.15.0

问题现象 #

1. 编写auth.py时，VS Code提示「Import "flaskr.db" could not be resolved」导入错误；
2. 执行flask run后服务启动正常，但首页显示Not Found，访问http://127.0.0.1:5000/auth/login触发Internal Server Error；
3. 此前「Application Setup」步骤可正常显示Hello World。

已尝试操作 #

• 执行export FLASK_APP=flaskr后重启服务，问题未解决。

解决步骤 #

1. 修复VS Code导入警告 #

VS Code的导入提示错误是因为项目根目录未加入Python分析路径，可通过以下方式解决：

• 在项目根目录创建.vscode/settings.json，添加内容：

{
    "python.analysis.extraPaths": ["./"]
}

• 或在终端执行export PYTHONPATH=$(pwd)，再重新启动VS Code。

2. 修复运行时错误 #

确认蓝图注册与DB初始化

检查flaskr/__init__.py，确保正确初始化db并注册auth蓝图，示例代码：

from flask import Flask
from flask_sqlalchemy import SQLAlchemy

db = SQLAlchemy()

def create_app():
    app = Flask(__name__)
    # 配置SQLite数据库路径
    app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///instance/flaskr.sqlite'
    app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False

    db.init_app(app)

    # 注册auth蓝图，设置URL前缀
    from .auth import auth as auth_blueprint
    app.register_blueprint(auth_blueprint, url_prefix='/auth')

    # 添加首页路由，解决Not Found问题
    @app.route('/')
    def index():
        return render_template('index.html') # 或返回基础文本

    return app

修正auth.py导入语句

确保auth.py中正确导入db，替换错误的导入方式：

from flask import Blueprint, render_template
from flaskr import db # 正确导入方式

auth = Blueprint('auth', __name__)

@auth.route('/login')
def login():
    return render_template('auth/login.html')

确认模板与文件结构

检查项目结构是否符合教程要求：

flask-tutorial/
├── flaskr/
│   ├── __init__.py
│   ├── auth.py
│   ├── templates/
│   │   ├── index.html
│   │   └── auth/
│   │       └── login.html
│   └── static/
├── instance/
└── .venv/

初始化数据库并启动服务

在终端执行以下命令：

export FLASK_APP=flaskr
export FLASK_ENV=development
flask init-db # 初始化数据库（需确保__init__.py中包含init-db命令）
flask run

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