创建Flask URL短链接应用时遇ModuleNotFoundError: No module named 'decouple'

AI 小北

2026-7-26

解决ModuleNotFoundError: No module named 'decouple'（已安装python-decouple仍报错）

针对你遇到的问题，按以下步骤逐一排查：

确认Pipfile中已正确添加依赖
检查项目根目录的Pipfile，确保[packages]区块下存在python-decouple = "*"（或指定版本）。如果没有，在终端执行：
```
pipenv install python-decouple
```
务必通过pipenv安装，而非全局pip。
验证虚拟环境内的依赖状态
运行以下命令，确认python-decouple确实在pipenv虚拟环境中安装：
```
pipenv run pip list
```
若输出中无python-decouple，执行重装命令：
```
pipenv uninstall python-decouple && pipenv install python-decouple
```
也可直接测试导入：
```
pipenv run python -c "from decouple import config; print('导入成功')"
```
能打印"导入成功"说明环境依赖正常。
确保项目使用pipenv虚拟环境的解释器
1. 终端中先激活虚拟环境：
```
pipenv shell
```
  再运行数据库初始化命令，看是否报错。
2. 若使用IDE（如VS Code、PyCharm），需手动选择pipenv对应的解释器：
  - VS Code：按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入Python: Select Interpreter，选择路径包含virtualenvs且对应项目名的解释器。
  - PyCharm：File -> Settings -> Project: [项目名] -> Python Interpreter，添加并选择pipenv的虚拟环境解释器。
检查import语句是否正确
确认config.py中的导入代码是：
```
from decouple import config
```
避免写错模块名或调用方式。
清理缓存并重置环境
清除pipenv缓存后重新安装依赖：
```
pipenv --clear
pipenv install
```
若使用IDE，可尝试清理IDE缓存（如VS Code重启窗口、PyCharm执行File -> Invalidate Caches...并重启），避免缓存导致的解释器识别异常。