Python 导入错误：找不到 config 模块的解决方法
问题背景
当 Python 解释器抛出 "ModuleNotFoundError: No module named 'config'" 错误时，表示代码中试图引入一个名为 config 的模块，但解释器在其搜索路径中无法定位该模块。这种问题常见于三种场景：模块未安装、路径配置有误、名称冲突。
1. 模块尚未安装
这是最直接的原因——目标模块并未存在于当前环境中。解决方法如下：
- 使用包管理工具安装所需模块，例如执行
pip install config。 - 确认导入的模块名称与实际安装的包名完全一致。例如，如果实际模块叫
configparser，而写了import config，就会触发该错误。
2. 模块路径不在搜索范围内
即便模块存在于项目目录中，若其所在路径未被 Python 纳入模块搜索路径，同样会报错。处理方式包括：
- 检查项目文件夹结构，确保
config.py位于正确的子目录或根目录。 - 通过
sys.path查看当前搜索路径列表，确认模块所在目录是否在其中。 - 若路径缺失，可临时添加：
sys.path.append('/path/to/module')，或设置环境变量PYTHONPATH。
3. 模块名称冲突
如果存在名称相同但功能不同的模块（例如内置模块或第三方库），Python 可能加载了错误的版本。解决办法：
- 使用绝对导入避免歧义，例如
import myproject.config而非import config。 - 检查是否存在自定义
config.py与系统模块重名，考虑重命名文件。
实际案例演示
以 Flask 应用为例说明修复过程。项目需要管理配置信息，创建 config.py 文件：
# config.py
class AppConfig:
DEBUG = False
SECRET = 'replace-this-with-real-secret'
DB = {
'host': 'localhost',
'port': 5432,
'user': 'admin',
'password': 'securepass',
'dbname': 'appdb'
}
class DevConfig(AppConfig):
DEBUG = True
在应用入口文件中正确引用：
# main.py
from flask import Flask
from config import DevConfig
app = Flask(__name__)
app.config.from_object(DevConfig)
@app.route('/')
def home():
return 'Application is running'
if __name__ == '__main__':
app.run()
上面代码中，通过 from config import DevConfig 直接引入配置类，然后用于 Flask 设置。注意 config.py 与 main.py 必须在同一目录下，否则需要调整导入路径或使用上述第2节的方法。
config 模块常见用途
很多 Python 项目将配置集中管理在一个 config 模块中，这样做的好处包括：
- 配置与业务代码分离，修改配置无需改源代码。
- 支持多环境配置（开发、测试、生产）通过不同配置类切换。
- 便于从环境变量、配置文件甚至命令行参数动态加载配置。
典型用法是定义一个 Config 基类，然后派生子类覆盖特定参数。应用代码只需导入所需配置类，即可保持整洁。
