1. Django项目环境准备在开始构建Django项目之前我们需要确保开发环境已经准备就绪。我建议使用Python 3.8或更高版本这是目前Django官方推荐的支持版本。如果你还没有安装Python可以从官网下载对应操作系统的安装包。安装Python后强烈建议使用虚拟环境来隔离项目依赖。这是我多年开发总结出的最佳实践可以避免不同项目间的依赖冲突。创建虚拟环境很简单python -m venv myenv激活虚拟环境的方式根据操作系统有所不同Windows:myenv\Scripts\activatemacOS/Linux:source myenv/bin/activate虚拟环境激活后我们就可以安装Django了pip install django我通常会使用最新稳定版的Django但如果你需要特定版本可以指定版本号安装比如pip install django4.2。安装完成后可以通过python -m django --version来验证安装是否成功。2. 创建Django项目Django项目是整个Web应用的容器它包含多个应用(App)和共享配置。创建新项目使用startproject命令django-admin startproject myproject这个命令会生成一个基础项目结构让我们来看看这些文件的用途myproject/ manage.py myproject/ __init__.py settings.py urls.py asgi.py wsgi.pymanage.py是项目管理脚本我们后续的很多操作都会用到它。settings.py包含项目所有配置urls.py定义URL路由asgi.py和wsgi.py是项目部署时使用的入口文件。我建议在项目创建后立即做几件事在settings.py中设置正确的时区如TIME_ZONE Asia/Shanghai配置ALLOWED_HOSTS开发时可以设为[*]但生产环境一定要指定具体域名检查DEBUG设置开发时设为True生产环境必须设为False3. 创建Django应用Django项目由多个应用(App)组成每个应用负责一个特定的功能模块。创建应用的命令是python manage.py startapp myapp这个命令会生成一个应用目录结构myapp/ __init__.py admin.py apps.py migrations/ __init__.py models.py tests.py views.py创建应用后必须将其添加到项目的INSTALLED_APPS中。打开myproject/settings.py在INSTALLED_APPS列表中添加你的应用名称INSTALLED_APPS [ ... myapp, ]我通常会按照功能模块来划分应用比如用户管理可以是一个应用商品管理可以是另一个应用。这种模块化设计让项目更易于维护和扩展。4. 配置数据库和模型Django默认使用SQLite数据库这对于开发和小型项目已经足够。如果你需要使用MySQL或PostgreSQL可以在settings.py中修改DATABASES配置。定义模型是在models.py中完成的。模型是Django与数据库交互的核心每个模型类对应数据库中的一个表。例如from django.db import models class Article(models.Model): title models.CharField(max_length200) content models.TextField() created_at models.DateTimeField(auto_now_addTrue) updated_at models.DateTimeField(auto_nowTrue) def __str__(self): return self.title定义好模型后需要生成并应用迁移python manage.py makemigrations python manage.py migrate迁移是Django管理数据库变更的强大工具它允许你随着应用的发展逐步修改数据库结构而不会丢失数据。5. 创建视图和URL路由视图是处理请求并返回响应的Python函数或类。在views.py中我们可以定义简单的视图from django.http import HttpResponse def home(request): return HttpResponse(欢迎来到我的网站!)为了让这个视图可以被访问我们需要在urls.py中配置URL路由。首先在应用目录下创建urls.py文件from django.urls import path from . import views urlpatterns [ path(, views.home, namehome), ]然后在项目的主urls.py中包含这个应用的URL配置from django.contrib import admin from django.urls import path, include urlpatterns [ path(admin/, admin.site.urls), path(, include(myapp.urls)), ]这种两级URL配置的方式让项目结构更清晰每个应用管理自己的URL路由项目主URL配置只负责分发。6. 启动开发服务器Django自带一个轻量级的开发服务器非常适合开发和测试。启动服务器的命令是python manage.py runserver默认情况下服务器会监听8000端口。你可以在浏览器中访问http://127.0.0.1:8000/查看你的网站。如果需要更改端口或让其他设备可以访问可以使用python manage.py runserver 0.0.0.0:8000开发服务器会自动检测代码变更并重新加载但在添加新文件时可能需要手动重启。7. 使用Django管理后台Django自带一个功能强大的管理后台可以方便地管理数据。要使用它首先需要创建超级用户python manage.py createsuperuser按照提示输入用户名、邮箱和密码。然后访问http://127.0.0.1:8000/admin/登录管理后台。为了让模型出现在管理后台需要在应用的admin.py中注册它们from django.contrib import admin from .models import Article admin.site.register(Article)现在你可以在管理后台中查看、添加、编辑和删除文章了。8. 项目进阶配置随着项目发展你可能需要进行更多配置。以下是一些常见配置项静态文件配置在settings.py中添加STATIC_URL /static/ STATICFILES_DIRS [BASE_DIR / static]模板配置确保TEMPLATES设置中包含DIRS: [BASE_DIR / templates],国际化设置LANGUAGE_CODE zh-hans USE_I18N True USE_L10N True USE_TZ True日志配置添加日志记录可以帮助调试LOGGING { version: 1, disable_existing_loggers: False, handlers: { console: { class: logging.StreamHandler, }, }, root: { handlers: [console], level: INFO, }, }9. 常见问题解决在实际开发中你可能会遇到一些问题。以下是我总结的几个常见问题及解决方法数据库连接问题检查settings.py中的数据库配置确保数据库服务正在运行用户名和密码正确。静态文件不显示确保DEBUGTrue检查STATIC_URL和STATICFILES_DIRS设置运行python manage.py collectstatic收集静态文件。模板找不到检查TEMPLATES设置中的DIRS确保模板文件放在正确目录下。迁移问题如果迁移出错可以尝试删除迁移文件除了__init__.py和数据库然后重新创建迁移。端口被占用使用python manage.py runserver 8080指定其他端口。10. 项目部署准备虽然开发服务器适合本地开发但绝不能在生产环境中使用。部署Django项目需要考虑以下几个方面选择生产服务器常用选择包括Gunicorn、uWSGI等配置Web服务器Nginx或Apache作为反向代理设置数据库生产环境推荐使用PostgreSQL或MySQL静态文件处理配置Nginx直接提供静态文件安全配置确保DEBUGFalse设置正确的ALLOWED_HOSTS使用HTTPS一个简单的生产环境部署可以使用Gunicorn和Nginxpip install gunicorn gunicorn myproject.wsgi:application --bind 0.0.0.0:8000然后在Nginx配置中添加反向代理规则。11. 持续学习和资源推荐Django有着丰富的功能和强大的社区支持。以下是我推荐的学习资源官方文档Django文档非常全面是学习的第一手资料Django Girls教程适合初学者的友好教程Awesome Django收集了各种Django相关的资源和库Django Packages查找可重用的Django应用社区论坛如Django Forum和Stack Overflow在实际项目中我建议从小功能开始逐步构建。Django的电池全包含哲学意味着很多常用功能已经内置不需要重复造轮子。