Flask项目在PyCharm可运行但VS Code/Heroku报错如何不改结构解决

问题根因 #

报错核心原因是不同运行环境的Python模块搜索路径（sys.path）不一致：

• PyCharm默认会自动将打开的项目根目录（即你的system文件夹）加入搜索路径，因此带backend.前缀的导入可正常识别
• VS Code终端、Heroku默认工作目录与PyCharm不一致，无法匹配带backend.前缀的导入规则，修改导入规则后又和PyCharm的默认路径配置冲突

最优解决方案（不改动项目结构、符合Python导入规范） #

无需修改现有代码的目录结构，统一使用带backend.前缀的绝对导入，适配所有环境：

1. 先撤销之前的修改：删除app.py中import sys和sys.path.append('./')两行代码，所有导入语句改回原有带backend.前缀的写法，示例如下：
   • app.py中导入改为from backend.controller.account import BaseAccount
   • controller/account.py中导入改为from backend.model.account import AccountDAO
   • 其他涉及导入的地方统一加上backend.前缀
2. 适配各环境运行配置：
   • PyCharm：无需额外修改，原有配置可正常运行，且不会报Unresolved reference错误
   • VS Code：两种运行方式二选一即可：
     • 终端运行：先切换到项目根目录（system文件夹），执行命令flask --app backend.app run
     • 固定运行配置：在.vscode/launch.json中添加如下配置，直接点击运行即可：

       {
           "version": "0.2.0",
           "configurations": [
               {
                   "name": "Python: Flask",
                   "type": "python",
                   "request": "launch",
                   "module": "flask",
                   "env": {
                       "FLASK_APP": "backend.app",
                       "FLASK_ENV": "development"
                   },
                   "args": [
                       "run"
                   ],
                   "cwd": "${workspaceFolder}"
               }
           ]
       }
       

   • Heroku：修改代码根目录下的Procfile内容为：

     web: gunicorn backend.app:app
     

     Heroku默认工作目录为代码仓库根目录，该配置可直接匹配带backend.前缀的导入规则。

替代方案（保留无前缀导入） #

如果不想修改现有导入语句，可直接在PyCharm中右键选中backend文件夹，选择Mark Directory as -> Sources Root，PyCharm会将backend目录加入搜索路径，即可消除Unresolved reference报错，VS Code和Heroku的原有配置无需改动。该方案不符合Python绝对导入规范，仅适合临时调试使用。

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