1. 引言
Django 作为 Python 生态中最流行的 Web 框架之一,凭借其「开箱即用」的全栈特性,深受开发者喜爱。而 PyCharm 作为 JetBrains 出品的专业 Python IDE,内置了对 Django 的一流支持,包括模板引擎提示、ORM 模型导航、管理命令快捷入口等。本文将带你从零开始,在 PyCharm 中搭建并开发一个完整的 Django 项目,全程配有可直接运行的代码实例。
2. 环境准备与项目创建
2.1 安装与配置 Python 解释器
首先确保本机已安装 Python 3.8 及以上版本。打开 PyCharm,在欢迎界面点击「New Project」,选择 Django 项目类型。PyCharm 会自动检测系统中的 Python 解释器,也可以点击右侧齿轮手动指定虚拟环境路径。
# 手动创建虚拟环境(可选) python -m venv venv # 激活虚拟环境 # Windows venv\Scripts\activate # macOS / Linux source venv/bin/activate # 安装 Django pip install django2.2 使用 PyCharm 创建 Django 项目
在 PyCharm 的「New Project」对话框中,左侧选择「Django」,填写项目名称(例如myblog),PyCharm 会自动生成项目骨架,包括manage.py、myblog配置目录以及默认的templates目录。点击「Create」后,等待依赖安装完成即可。
# 项目结构预览 myblog/ ├── manage.py ├── myblog/ │ ├── __init__.py │ ├── settings.py │ ├── urls.py │ └── wsgi.py └── templates/3. 创建应用与配置路由
3.1 创建 Django 应用
在 PyCharm 底部的「Terminal」面板中执行以下命令,创建一个名为blog的应用:
python manage.py startapp blog创建完成后,需要在settings.py的INSTALLED_APPS中注册该应用:
# myblog/settings.py INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', 'blog', # 新增应用 ]3.2 配置 URL 路由
在myblog/urls.py中引入blog应用的视图,并配置根路由:
# myblog/urls.py from django.contrib import admin from django.urls import path, include urlpatterns = [ path('admin/', admin.site.urls), path('', include('blog.urls')), ]接着在blog应用目录下新建urls.py文件:
# blog/urls.py from django.urls import path from . import views urlpatterns = [ path('', views.index, name='index'), ]4. 编写视图与模板
4.1 编写视图函数
打开blog/views.py,编写一个简单的首页视图,向模板传递文章列表数据:
# blog/views.py from django.shortcuts import render from .models import Article def index(request): articles = Article.objects.all().order_by('-created_at') return render(request, 'blog/index.html', {'articles': articles})4.2 创建 HTML 模板
在blog应用下创建templates/blog/index.html文件,PyCharm 会自动识别 Django 模板语法并提供补全提示:
<!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="UTF-8"> <title>我的博客</title> </head> <body> <h1>最新文章</h1> {% for article in articles %} <div> <h2>{{ article.title }}</h2> <p>{{ article.content|truncatechars:100 }}</p> <small>发布于 {{ article.created_at }}</small> </div> {% empty %} <p>暂无文章</p> {% endfor %} </body> </html>5. 定义数据模型与迁移
5.1 编写模型类
在blog/models.py中定义Article模型,PyCharm 会为模型字段提供类型检查和自动补全:
# blog/models.py from django.db import models class Article(models.Model): title = models.CharField(max_length=200, verbose_name='标题') content = models.TextField(verbose_name='正文') created_at = models.DateTimeField(auto_now_add=True, verbose_name='创建时间') class Meta: ordering = ['-created_at'] def str(self): return self.title</code></pre> 5.2 生成并执行迁移 在 PyCharm 的 Terminal 中依次执行以下命令,PyCharm 会高亮提示迁移文件的变化: python manage.py makemigrations python manage.py migrate 6. 使用 Django 管理后台 6.1 注册模型到后台 编辑 blog/admin.py,将 Article 模型注册到 Django Admin: blog/admin.py from django.contrib import admin from .models import Article @admin.register(Article) class ArticleAdmin(admin.ModelAdmin): list_display = ('title', 'created_at') search_fields = ('title',) 6.2 创建超级用户并启动服务 在 Terminal 中执行以下命令创建管理员账号,然后点击 PyCharm 右上角的运行按钮启动开发服务器: python manage.py createsuperuser python manage.py runserver 浏览器访问 http://127.0.0.1:8000/admin/,使用刚创建的账号登录,即可在后台发布文章。 7. 调试技巧与快捷键 7.1 断点调试 PyCharm 支持在 Django 视图、模型方法中直接打断点。点击代码行号左侧的空白区域添加断点,然后点击右上角的「Debug」按钮,即可在请求处理过程中逐步查看变量值。例如在 views.py 的 articles 查询语句处打断点,可以实时查看 ORM 生成的 SQL。 7.2 常用快捷键 功能 快捷键(Windows / macOS) 快速跳转到模板对应视图 Ctrl + B / Cmd + B 运行 Django 管理命令 Ctrl + Shift + R / Cmd + Shift + R 格式化代码 Ctrl + Alt + L / Cmd + Option + L 全局搜索 双击 Shift 8. 总结 本文从环境配置、项目创建、路由配置、视图模板、数据模型到管理后台,完整演示了在 PyCharm 中开发 Django 项目的全流程。PyCharm 的智能提示、断点调试和内置终端,能显著提升 Django 开发效率。建议读者在此基础上继续探索 Django 的认证系统、REST Framework 以及部署方案,逐步构建完整的生产级应用。