Windows 下从零开始安装 Django:新手到进阶全攻略
如果你想在 Windows 电脑上搭建一个 Django 开发环境,却不知从何下手,那么你来对地方了。Django 是一个强大的 Python Web 框架,无论是做毕业设计、个人博客还是商业项目,它都是绝佳选择。今天,我们就来手把手带你完成从安装到创建第一个项目的全过程,即使你是电脑小白,也能跟着一步步搞定。
第一部分:安装前的准备工作
在安装 Django 之前,我们需要先准备好它的“地基”——Python 和 pIP。
1. 安装 Python
Django 是用 Python 写的,所以第一步必须安装 Python。
步骤:
- 访问 Python 官网,进入下载页面。选择最新的稳定版本(如 Python 3.11.x),点击“Windows installer (64-bit)”进行下载。除非你明确知道要用32位系统,否则都选64位。
- 双击运行下载好的安装程序(.exe文件)。
- 在安装向导中,务必勾选最下方的 “Add Python 3.11 to PATH” 选项。这是最关键的一步,勾选后系统才能识别 Python 命令。
- 点击 “Install Now” 开始安装。安装完成后,点击 “Close”。

验证安装是否成功:
- 按下键盘上的
Win + R键,输入cmd,然后按回车,打开命令提示符窗口。 - 在黑色的命令窗口中,输入
python --version并按回车。 - 如果显示类似 “Python 3.11.5” 的版本号,恭喜你,Python 安装成功!
2. 认识 pip 工具
pip 是 Python 的包管理工具,可以把它想象成 Python 的“应用商店”。我们安装 Django 就需要用到它。通常,安装 Python 时 pip 已经自动安装好了。
验证 pip 是否可用:
在刚才的命令提示符窗口中,输入 pip --version 并按回车。如果显示 pip 的版本信息,说明一切正常。
第二部分:安装 Django 的两种主流方法
准备工作就绪,现在可以正式安装 Django 了。这里推荐两种方法,第一种最适合新手。
方法一:使用 pip 直接安装(推荐)
这是最标准、最常用的安装方式。
操作步骤:
- 保持命令提示符窗口打开。
- 输入以下命令并回车:
pip install django - 等待安装。你会看到屏幕滚动很多信息,pip 正在从网络下载 Django 及其依赖包。请保持网络通畅。
- 安装完成后,输入
django-admin --version回车。如果显示 Django 的版本号(如 4.2.x),则表明安装成功。
新手避坑指南:
- 速度慢怎么办? 由于网络原因,下载可能会很慢。可以使用国内的镜像源加速。例如,使用清华大学的镜像,命令改为:
pip install django -i https://pypi.tuna.tsinghua.edu.cn/simple - 提示“不是内部或外部命令”? 如果
pip或django-admin命令无效,大概率是当初安装 Python 时没有勾选 “Add to PATH”。需要卸载 Python 后重新安装,并确保勾选该选项。
方法二:创建虚拟环境后安装(进阶实践)
在实际项目开发中,强烈建议使用“虚拟环境”。你可以把它理解为一个独立的、干净的房间。不同的项目可能需要不同版本的 Django 或其它库,虚拟环境可以避免它们相互冲突。
操作步骤:
- 为你的项目创建一个专属文件夹,例如在桌面上新建一个叫
my_django_project的文件夹。 - 在命令提示符中,使用
cd命令进入这个文件夹。例如:cd C:\Users\你的用户名\Desktop\my_django_project - 创建虚拟环境。输入以下命令,会在当前文件夹下创建一个名为
venv的虚拟环境目录。python -m venv venv - 激活虚拟环境。输入:
venv\Scripts\activate激活后,你会看到命令提示符前面多了一个
(venv)标记,这表示你已经进入了这个独立的环境。 - 在虚拟环境中安装 Django:
pip install django - 后续所有项目操作都在这个激活的虚拟环境下进行。要退出虚拟环境,只需输入
deactivate。
第三部分:创建并运行你的第一个 Django 项目
安装成功,让我们立刻体验一下 Django 的魅力。
创建项目:
- 在命令提示符中(如果在虚拟环境中,请确保
(venv)标记存在),切换到你想放置项目的目录,比如桌面。 - 运行以下命令来创建一个名为
mysite的项目:django-admin startproject mysite这会在当前目录生成一个
mysite文件夹。
启动开发服务器:
- 使用
cd命令进入项目文件夹:cd mysite - 运行启动命令:
python manage.py runserver - 你会看到输出信息中包含 “Starting development server at http://127.0.0.1:8000/”。
在浏览器中查看:
- 打开你的浏览器(如 Chrome、Edge)。
- 在地址栏输入
http://127.0.0.1:8000/并访问。 - 如果看到一个带有火箭图样的欢迎页面,上面写着 “The install worked successfully! Congratulations!”,那么你的第一个 Django 项目就成功运行了!
如何停止服务器:
回到命令提示符窗口,按下组合键 Ctrl + C 即可停止开发服务器。
第四部分:常见问题与故障排除
-
安装过程中报错,提示“Permission denied”或“访问被拒绝” 尝试以管理员身份运行命令提示符。在开始菜单搜索“cmd”,右键点击“命令提示符”,选择“以管理员身份运行”,再执行安装命令。
-
运行
runserver后无法访问 8000 端口 可能是端口被占用。你可以指定另一个端口,例如:python manage.py runserver 8080然后在浏览器访问
http://127.0.0.1:8080/。 -
想安装特定版本的 Django 比如需要安装与教程一致的 Django 3.2 版本,可以使用:
pip install django==3.2 -
如何卸载或升级 Django?
- 卸载:
pip uninstall django - 升级:
pip install --upgrade django
- 卸载:
进阶建议与下一步
恭喜你成功搭建了 Django 环境!为了后续学习更顺畅,这里有几个建议:
- 学习路线: 接下来建议学习 Django 的官方教程,它会带你创建一个简单的投票应用,涵盖模型、视图、模板等核心概念。
- 开发工具: 可以考虑使用专业的代码编辑器,如 Visual Studio Code 或 PyCharm。它们对 Django 有很好的支持,能自动补全代码、高亮语法,大大提高效率。
- 版本控制: 尽早学习使用 Git,并注册一个 GitHub 账号。这是管理代码、团队协作和备份项目的行业标准工具。
- 数据库: Django 默认使用轻量级的 SQLite,对初学者友好。等项目需要时,再学习配置 MySQL 或 PostgreSQL。
记住,编程是一个边学边练的过程。遇到错误不要慌,仔细阅读命令行给出的错误提示,它们通常已经指明了方向。多动手,多尝试,你很快就能用 Django 构建出属于自己的网络应用了。

还没有评论,来说两句吧...