### 解决方案概述 在Python中遇到`No module named 'django'`的问题时，通常是因为Django模块未正确安装或Python解释器无法找到其安装路径。以下是可能的原因及解决方案[^2]。 ### 1. 检查Django是否已正确安装 运行以下命令检查Django是否已安装： ```bash pip show django ``` 如果输出为空，则说明Django未安装。可以使用以下命令重新安装： ```bash pip install django ``` 如果已经安装但仍然报错，可能是由于多个Python版本共存导致的。确保使用的pip与Python解释器版本一致。例如： ```bash python -m pip install django ``` ### 2. 检查模块搜索路径 有时即使Django已安装，Python仍无法找到它。这可能是由于`sys.path`中缺少Django的安装路径。可以通过以下代码查看当前的模块搜索路径： ```python import sys print(sys.path) ``` 如果路径中缺少Django的安装目录（如`site-packages`），可以通过以下方式手动添加： ```python import sys sys.path.append('/path/to/django') # 替换为实际路径 ``` 需要注意的是，这种方式仅在当前会话中有效。若需永久修改，可以配置环境变量`PYTHONPATH`[^4]。 ### 3. 配置环境变量`PYTHONPATH` 在Windows系统中，可以通过以下步骤配置`PYTHONPATH`： 1. 打开系统属性 -> 高级系统设置 -> 环境变量。 2. 在用户变量或系统变量中新增或编辑`PYTHONPATH`，添加Django的安装路径（如`C:\Python27\Lib;C:\Python27\Lib\site-packages`）。 3. 保存后重启命令行工具以使更改生效。 在Linux或MacOS系统中，可以在`.bashrc`或`.zshrc`文件中添加以下内容： ```bash export PYTHONPATH=$PYTHONPATH:/path/to/django ``` 然后运行`source ~/.bashrc`或`source ~/.zshrc`使更改生效。 ### 4. 检查用户权限问题 如果使用非root用户安装Django，可能会导致某些服务（如uWSGI）无法访问依赖。这是因为依赖被安装在用户的本地目录（如`/home/cc/.local`），而服务运行时可能只读取全局路径（如`/usr/local`）。可以通过以下方式解决： - 使用root用户安装Django： ```bash sudo pip install django ``` - 或者将用户本地安装的依赖路径添加到`PYTHONPATH`中[^5]。 ### 5. 检查虚拟环境配置 如果使用了虚拟环境（virtualenv或venv），需要确保在激活虚拟环境后安装Django。激活虚拟环境的命令如下： ```bash source /path/to/venv/bin/activate # Linux/MacOS .\path\to\venv\Scripts\activate # Windows ``` 然后在虚拟环境中安装Django： ```bash pip install django ``` ### 示例代码：验证Django安装 以下代码可用于验证Django是否正确安装并可用： ```python import django print(django.get_version()) ``` 如果运行时无错误且输出Django版本号，则说明安装成功。 ### 注意事项 - 确保pip和Python版本匹配。例如，对于Python 3.x，应使用`pip3`而非`pip`。 - 如果同时安装了多个Python版本，请明确指定使用的解释器版本，例如`python3 -m pip install django`。