要启动一个 Django 项目，需要按照以下步骤操作（以你提供的风电场项目为例）：
前提条件
已安装 Python（推荐 Python 3.8+），可通过 python --version 或 python3 --version 检查是否安装。 项目文件已准备好（即你提供的 windfarm_digital_twin 目录结构）。
详细启动步骤
1. 进入项目根目录
首先通过终端（命令提示符 / 终端）进入项目根目录（即包含 manage.py 的目录）：
# 假设项目在本地路径为 ~/windfarm_digital_twin
cd ~/windfarm_digital_twin
2. 创建并激活虚拟环境（推荐）
为了避免依赖冲突，建议使用虚拟环境管理项目依赖：
Windows 系统
# 创建虚拟环境（venv是环境名称，可自定义）
python -m venv venv
# 激活虚拟环境
venv\Scripts\activate
Mac/Linux 系统
# 创建虚拟环境
python3 -m venv venv
# 激活虚拟环境
source venv/bin/activate
激活成功后，终端提示符前会出现 (venv) 标识，表示当前处于虚拟环境中。
3. 安装 Django 依赖
项目依赖 Django 框架，需在虚拟环境中安装：
# 安装Django（指定与项目兼容的版本，例如3.2.x）
pip install django==3.2.20
如果项目有其他依赖（如后续扩展可能用到的 django-cors-headers 等），可创建 requirements.txt 文件统一管理，然后通过 pip install -r requirements.txt 安装。
4. 数据库迁移（初始化数据库）
项目中定义了 WindTurbine 数据模型，需要将模型同步到数据库（默认使用 SQLite）：
# 生成迁移文件（根据models.py创建数据库表结构描述）
python manage.py makemigrations
# 执行迁移（将迁移文件应用到数据库，创建实际的表）
python manage.py migrate
执行成功后，项目根目录会生成 db.sqlite3 文件（SQLite 数据库文件）。
5. 创建超级用户（可选，用于管理后台）
如需通过 Django admin 后台管理风机数据，需创建超级用户：
python manage.py createsuperuser
按照提示输入用户名、邮箱（可选）、密码（输入时不显示，输入完成回车即可）。
6. 启动开发服务器
通过 Django 内置的开发服务器启动项目：
python manage.py runserver
启动成功后，终端会显示类似以下信息：
Watching for file changes with StatReloader
Performing system checks...
System check identified no issues (0 silenced).
October 20, 2025 - 10:00:00
Django version 3.2.20, using settings 'windfarm.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.
7. 访问项目
打开浏览器，访问以下地址：
项目首页：http://127.0.0.1:8000/（三维风电场场景页面） 管理后台：http://127.0.0.1:8000/admin/（使用步骤 5 创建的超级用户登录，可添加 / 编辑风机数据）
停止服务器
在终端中按 Ctrl + C 即可停止开发服务器。退出虚拟环境可执行：
deactivate # 无论Windows还是Mac/Linux，均使用此命令
常见问题
- 如果启动时报错 “端口被占用”，可指定其他端口启动：python manage.py runserver 8080（使用 8080 端口）。
- 如果数据库迁移失败，检查 models.py 是否有语法错误，或删除 migrations 目录下的文件（除 init.py 外）后重新执行 makemigrations 和 migrate。
- 首次访问首页可能没有风机数据，需先通过 admin 后台添加风机信息（填写名称、经纬度、模型路径等）。
版权声明：如无特殊说明，文章均为本站原创，转载请注明出处
本文链接：http://jiangyudong.top/subject/article/DjangoStart/
许可协议：署名-非商业性使用 4.0 国际许可协议
