Django项目迁移manage.py至根目录后settings.py导入错误求助

我明白你现在的困境——把manage.py从src移到根目录适配Heroku，结果本地跑起来就遇到了导入错误。别着急，咱们一步步来解决这个问题。

首先，这个ImportError: No module named src.tweetme.settings的核心原因是：当你在项目根目录运行manage.py时，Python的默认搜索路径里并不包含src目录，而且src可能还没被标记为可导入的Python包。

下面是几个可行的解决方案，按优先级推荐：

方案1：把src目录加入Python搜索路径（最直接） #

在你的根目录manage.py里，导入sys之后，添加一行代码把src目录手动加入到Python的路径中。这样Python就能找到src下的所有模块了。

修改后的完整manage.py代码如下：

#!/usr/bin/env python
import os
import sys

# 关键：把当前目录下的src文件夹添加到Python搜索路径
sys.path.insert(0, os.path.join(os.path.dirname(__file__), 'src'))

if __name__ == "__main__":
    # 注意：这里的路径要严格匹配你的实际settings位置
    # 比如如果你的settings在src/tweetme/settings.py，就用"tweetme.settings"
    # 如果是分环境的配置（比如src/mainProject/Settings/local.py），就改成"mainProject.Settings.local"
    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "tweetme.settings")
    try:
        from django.core.management import execute_from_command_line
    except ImportError:
        try:
            import django
        except ImportError:
            raise ImportError(
                "Couldn't import Django. Are you sure it's installed and "
                "available on your PYTHONPATH environment variable? Did you "
                "forget to activate a virtual environment?"
            )
        raise
    execute_from_command_line(sys.argv)

方案2：确保src是可导入的Python包 #

在src目录下创建一个空的__init__.py文件（如果还没有的话）。这个文件是Python识别目录为模块包的标志，有了它，src.tweetme.settings这种导入路径才能被正确解析。

方案3：检查settings模块的路径是否正确 #

从你的项目结构来看，src下有个mainProject目录，里面的Settings文件夹包含了base.py、local.py等配置文件。如果你的原项目里tweetme其实就是mainProject的别名，那你需要把DJANGO_SETTINGS_MODULE改成mainProject.Settings.local（或者你正在使用的环境配置文件），而不是src.tweetme.settings——路径写错也会导致导入失败。

验证方法 #

你可以在项目根目录打开Python交互环境，测试导入是否正常：

import os
import sys
sys.path.insert(0, os.path.join(os.path.dirname(__file__), 'src'))
# 替换成你的实际settings路径
import mainProject.Settings.local

如果没有报错，说明路径设置没问题，再去运行python manage.py runserver就应该正常了。

这个方案同时适配Heroku部署——Heroku会从根目录启动manage.py，我们添加的路径配置在云端也能正常工作。

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