### 使用 `python manage.py runserver` 启动 Django 开发服务器 执行 `python manage.py runserver` 命令时，Django 开发服务器的启动需要满足多个条件。如果命令无法正常运行，通常是因为环境配置或代码问题导致[^1]。 #### 环境检查 确保以下条件已满足： - 已正确安装 Django 框架，并且其路径已添加到系统的 `PYTHONPATH` 环境变量中。 - 使用的 Python 版本与 Django 兼容。例如，Django 3.x 需要 Python 3.6 或更高版本[^2]。 - 虚拟环境已激活（如果使用虚拟环境）。可以通过以下命令激活虚拟环境： ```bash source venv/bin/activate # Linux/Mac .\venv\Scripts\activate # Windows ``` #### 代码修改 在某些情况下，`manage.py` 文件中的导入语句可能引发异常。例如，以下代码片段可能导致问题： ```python try: from django.core.management import execute_from_command_line except ImportError as exc: 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?" ) from exc ``` 如果 Django 安装不完整或未正确配置，上述代码会抛出错误。可以尝试注释掉 `try...except` 块以直接定位问题[^1]。 #### 启动命令 在终端中输入以下命令以启动开发服务器： ```bash python manage.py runserver ``` 默认情况下，服务器将在 `http://127.0.0.1:8000/` 上运行。如果需要指定其他端口，可以附加端口号参数，例如： ```bash python manage.py runserver 8080 ``` #### 常见问题及解决方法 1. **浏览器无法访问**：如果在浏览器中访问 `http://127.0.0.1:8000/` 时显示无法访问，可能是防火墙阻止了连接，或者 IIS 等其他服务占用了端口[^2]。 - 检查是否有其他程序占用端口 8000。可以通过以下命令查看： ```bash netstat -ano | findstr :8000 ``` - 如果发现冲突，可以选择其他端口启动服务器。 2. **报错信息“Couldn't import Django”**：此错误表明系统未能找到 Django 模块。请验证 Django 是否已正确安装： ```bash pip show django ``` 如果未安装，可以使用以下命令进行安装： ```bash pip install django ``` 3. **编码问题**：如果最后一行的编码格式有问题，可能会导致运行失败。建议将文件保存为 UTF-8 编码格式，并确保没有多余的空格或特殊字符[^1]。 #### 示例代码 以下是一个完整的 `manage.py` 文件示例： ```python #!/usr/bin/env python """Django's command-line utility for administrative tasks.""" import os import sys def main(): os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings') try: from django.core.management import execute_from_command_line except ImportError as exc: 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?" ) from exc execute_from_command_line(sys.argv) if __name__ == '__main__': main() ``` #### 注意事项 如果仍然遇到问题，可以尝试重新创建项目： ```bash django-admin startproject myproject cd myproject python manage.py runserver ```