如何在Windows上运行原适配Linux文档的Django项目
2026-9-1
Windows系统部署django-event-management项目操作指引
前置环境准备
- 安装Python 3.8及以上版本，安装过程必须勾选Add Python to PATH选项，安装完成后打开PowerShell执行
python --version，能正常输出版本号即为配置成功 - 安装Git，安装完成后执行
git --version验证，返回版本信息即可
项目拉取与虚拟环境配置
- 进入你打算存放项目的本地文件夹，在文件夹地址栏输入
powershell回车，直接在当前路径打开终端 - 拉取项目源码：
git clone https://github.com/sajib1066/django-event-management.git - 进入项目根目录：
cd django-event-management - 创建Python虚拟环境：
python -m venv venv - 激活虚拟环境（直接替换Linux文档里的
source venv/bin/activate命令，PowerShell不支持source语法）：执行.\venv\Scripts\Activate.ps1若弹出脚本执行权限报错，先以管理员身份启动PowerShell，执行
Set-ExecutionPolicy RemoteSigned，输入Y确认策略修改后，回到普通终端重新执行激活命令即可
激活成功后终端输入行行首会出现(venv)标识，此时虚拟环境状态和Linux下执行source后的状态完全一致
依赖安装与项目初始化
- 安装项目所需依赖包：
pip install -r requirements.txt - 进入项目主配置目录：
cd event_management - 生成本地环境配置文件：执行
Copy-Item .env.example .env - 执行数据库迁移建表：
python manage.py migrate - 创建后台超级管理员账号：执行
python manage.py createsuperuser，按照终端提示依次输入用户名、邮箱、密码即可 - 收集项目静态资源：执行
python manage.py collectstatic，出现确认提示时输入yes回车
启动服务验证
- 在event_management目录下执行启动命令：
python manage.py runserver - 终端输出启动成功提示后，打开浏览器访问对应地址即可：
- 前台用户端：
http://127.0.0.1:8000 - 后台管理端：
http://127.0.0.1:8000/admin，使用之前创建的超级管理员账号登录即可
- 前台用户端：
常见问题排查
- 执行pip安装依赖时报编译类错误：安装微软Visual C++ Build Tools，安装时勾选「使用C++的桌面开发」组件，安装完成后重新执行依赖安装命令即可
- 页面样式加载异常：确认生成的.env文件中
DEBUG配置项值为True，重新执行静态资源收集命令后重启服务
内容的提问来源于stack exchange，提问作者Vivek
相关产品推荐
相关产品推荐
