Django 是基于 Python 的开源 Web 框架，环境搭建核心是「安装 Python → 配置虚拟环境（推荐）→ 安装 Django → 验证并创建项目」，以下是分步实操指南，兼顾新手友好性和生产环境规范：

一、前置准备：安装 Python 并配置环境

1. 下载安装 Python

• 官网下载：Python 官方下载页（推荐 3.8~3.12 版本，兼容 Django 3.2~5.0+）；
• 安装注意：
  • Windows：勾选「Add Python to PATH」（自动配置环境变量），若漏选需手动将 Python 安装目录（如 C:\Python310）和 Scripts 目录（如 C:\Python310\Scripts）加入系统 Path；
  • macOS/Linux：系统自带 Python 2.x，需安装 Python 3（macOS 可通过 brew install python3，Linux 可通过 apt install python3/yum install python3）。

2. 验证 Python 安装

打开终端 / 命令提示符（CMD），输入以下命令，返回版本号则安装成功：

bash

运行

python --version  # Windows
python3 --version # macOS/Linux（区分系统自带 Python 2）
pip --version     # 验证包管理工具（pip 随 Python 自动安装）

二、（推荐）创建虚拟环境（隔离项目依赖）

虚拟环境可避免不同 Django 项目的依赖版本冲突，是生产 / 开发的标准做法：

1. 创建并激活虚拟环境

系统	操作步骤
Windows	1. 新建项目文件夹（如 D:\django_projects），进入该文件夹：cd D:\django_projects2. 创建虚拟环境：python -m venv django_venv3. 激活虚拟环境：django_venv\Scripts\activate（激活后终端前缀会显示 (django_venv)）
macOS/Linux	1. 新建项目文件夹并进入：mkdir ~/django_projects && cd ~/django_projects2. 创建虚拟环境：python3 -m venv django_venv3. 激活虚拟环境：source django_venv/bin/activate

2. 退出虚拟环境（可选）

bash

运行

deactivate  # 任意系统通用

三、安装 Django

1. 基础安装（指定稳定版本）

激活虚拟环境后，通过 pip 安装（推荐指定版本，避免最新版兼容问题）：

bash

运行

# 安装最新稳定版（如 5.0）
pip install django
# 安装指定版本（如 3.2 LTS，长期支持版，适合生产环境）
pip install django==3.2

2. 验证 Django 安装

输入以下命令，返回版本号则安装成功：

bash

运行

django-admin --version

四、创建并运行第一个 Django 项目

1. 创建项目

在虚拟环境激活状态下，进入项目文件夹，执行：

bash

运行

# django-admin startproject 项目名
django-admin startproject myfirstsite

执行后会生成项目目录结构：

plaintext

myfirstsite/          # 项目根目录
├── manage.py         # 项目管理脚本（启动服务、创建应用等）
└── myfirstsite/      # 项目核心配置目录
    ├── __init__.py
    ├── settings.py   # 项目全局配置（数据库、静态文件等）
    ├── urls.py       # URL 路由配置
    ├── asgi.py       # ASGI 网关（适配异步/高并发）
    └── wsgi.py       # WSGI 网关（适配传统部署）

2. 启动开发服务器

进入项目根目录（含 manage.py 的目录），执行：

bash

运行

# 进入项目目录
cd myfirstsite
# 启动开发服务器（默认端口 8000）
python manage.py runserver
# 自定义端口（如 8080）
python manage.py runserver 8080
# 允许局域网访问（如本机 IP 192.168.1.100）
python manage.py runserver 0.0.0.0:8000

3. 验证项目运行

打开浏览器，访问 http://127.0.0.1:8000/，看到 Django 欢迎页面（火箭图标）则搭建成功。

五、（可选）创建 Django 应用（项目拆分）

一个 Django 项目可包含多个应用（如用户模块、商品模块），执行：

bash

运行

# python manage.py startapp 应用名
python manage.py startapp users

生成应用目录后，需在 settings.py 的 INSTALLED_APPS 中注册应用：

python

运行

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    ...,
    'users',  # 新增应用注册
]

六、常见问题排查

1. 「django-admin 不是内部或外部命令」：
   • 检查 Python 的 Scripts 目录是否加入 Path；
   • 虚拟环境未激活时，需用 django_venv\Scripts\django-admin.exe（Windows）或 django_venv/bin/django-admin（macOS/Linux）。
2. 运行服务器提示「端口被占用」：
   • 更换端口（如 runserver 8080）；
   • 关闭占用端口的进程（Windows：netstat -ano | findstr 8000 查 PID，taskkill /F /PID 进程号；macOS/Linux：lsof -i :8000 查 PID，kill -9 进程号）。
3. 安装 Django 报错「权限不足」：
   • Windows：以管理员身份运行 CMD；
   • macOS/Linux：添加 --user 参数（pip install --user django），避免全局安装权限问题。

总结

核心流程：Python 安装 → 虚拟环境创建激活 → Django 安装 → 项目创建与运行。虚拟环境是关键，能避免依赖冲突；开发服务器仅用于本地调试，生产环境需搭配 Nginx+Gunicorn/uWSGI 部署。