Flask使用manager.run()启动应用时遇ModuleNotFoundError问题求助

我来帮你拆解下这个问题，核心其实和Python的模块查找逻辑有关：

问题根源 #

PyCharm在运行项目时，会自动把你的项目根目录添加到Python的sys.path（模块搜索路径）里，所以它能顺利找到名为app的模块（这里要纠正下：你导入的from app import create_app, db里的app其实是一个包，不是你说的那个Flask实例变量哦）。但命令行直接运行时，Python只会把当前工作目录和系统默认路径加入sys.path，如果运行环境没配置对，自然找不到app包了。

你提到“app并非名为app.py的文件，而是一个创建的变量”——这里应该是混淆了概念：那个变量是create_app()函数返回的Flask实例，但导入语句里的app是你的包名，这个包的__init__.py里才定义了create_app、db这些对象。

具体解决办法 #

1. 确认项目结构是否规范 #

首先要保证你的项目是标准的Flask项目结构，大概长这样：

你的项目根目录/
├── app/                # 这是你的app包
│   ├── __init__.py     # 这里定义了create_app、db等核心对象
│   ├── routes.py
│   └── ...其他子模块
└── manage.py           # 管理文件，和app包同级

注意app文件夹里必须有__init__.py文件（Python 3.3+允许无，但为了兼容性和明确性，建议加上），这样Python才会把它识别为可导入的包。

2. 命令行运行时切换到项目根目录 #

打开命令行，先cd到你的项目根目录（也就是同时包含app包和manage.py的文件夹），再执行：

python manage.py

别直接在manage.py所在的子目录运行（如果它不在根目录的话），否则Python找不到上级目录的app包。

3. 手动把项目根目录加入sys.path #

如果上面的方法还是不行，可以在manage.py的最开头加这段代码，强制让Python识别你的项目根目录：

import sys
import os

# 获取当前文件所在的目录（即项目根目录）
project_root = os.path.abspath(os.path.dirname(__file__))
# 把根目录插入到模块搜索路径的最前面
sys.path.insert(0, project_root)

# 之后再执行导入
from app import create_app, db

4. 核对导入语句的正确性 #

最后再确认下：create_app和db确实是定义在app/__init__.py里的，这样from app import ...才能正确找到对应的对象。

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