零基础也能学会!手把手用Django搭你的第一个Python网站

敏锐星空
2026-05-02 02:36
阅读 2049

大家好,我是阿杰,一名在大厂干了三年后端开发的程序员,平时也在B站分享技术干货。最近收到不少粉丝私信:“完全没学过编程,能做网站吗?”“听说Django很适合新手,但不知道从哪开始。”看到这些问题,我特别理解——因为我当初学的时候也是一头雾水!

今天这篇教程,就是专门为零基础小白量身打造的。不需要你会HTML、不用懂数据库,只要会安装软件、能敲键盘,就能跟着做出一个真正的网站!而且我们会用上现代开发利器:GitHub CopilotChatGPT,让你事半功倍。


一、Django到底是什么?能做什么?

简单说,Django 是一个用 Python 写的“网站制造机”。它帮你自动处理那些繁琐的事情,比如用户登录、数据存储、页面跳转等。你只需要告诉它:“我要一个能发文章的博客”,它就能快速帮你搭建出来。

✅ Django 的优势:

  • 自带后台管理界面(连后台都不用自己写!)
  • 安全性高(防黑客攻击的机制都内置好了)
  • 社区强大(遇到问题搜一下基本都有答案)

二、环境准备:5分钟搞定开发工具

第一步:安装 Python

  • 去官网 python.org 下载 Python 3.8+(推荐 3.10 或 3.11)
  • 安装时务必勾选 “Add to PATH”(否则后面命令会报错!)

验证是否成功:

python --version
# 应该输出类似:Python 3.11.5

第二步:安装 Django

打开终端(Windows 用 CMD 或 PowerShell,Mac 用 Terminal),输入:

pip install django

💡 小贴士:如果你网速慢,可以换国内源:

pip install django -i https://pypi.tuna.tsinghua.edu.cn/simple/

第三步:选择你的代码编辑器

我强烈推荐 VS Code(免费 + 轻量 + 插件多):

  1. 下载安装 VS Code
  2. 安装插件:
    • Python
    • GitHub Copilot(自动写代码神器!)
    • Pylance(智能提示)

🤖 GitHub Copilot 怎么帮到你?
比如你输入注释 # 创建一个显示欢迎信息的视图,Copilot 可能自动补全整个函数!新手写代码不再卡壳。


三、核心概念:三个词搞懂 Django

别被术语吓到!Django 其实就靠这三个东西跑起来:

概念 通俗解释 类比
Project(项目) 整个网站的“总指挥部” 就像一栋大楼的总图纸
App(应用) 网站的一个功能模块 比如“用户系统”、“博客文章”都是独立 App
View(视图) 处理用户请求并返回页面的函数 相当于服务员:客人点菜 → 厨房做菜 → 上菜

✨ 记住:一个 Project 可以包含多个 App


四、实战:创建你的第一个网站!

我们来做一个超简单的“欢迎页面”。

步骤 1:创建项目

在你想放代码的文件夹里(比如桌面建个 myproject 文件夹),运行:

django-admin startproject mysite .

注意最后有个 .!这表示把项目文件直接放在当前目录,而不是嵌套一层。

你会看到生成了这些文件:

mysite/
    manage.py
    mysite/
        __init__.py
        settings.py   ← 配置文件(很重要!)
        urls.py       ← 网站的“导航地图”
        asgi.py
        wsgi.py

步骤 2:启动服务器

python manage.py runserver

打开浏览器,访问 http://127.0.0.1:8000 —— 看到那个火箭图标了吗?恭喜!你的网站已经跑起来了!

⚠️ 如果报错 “Port already in use”,说明8000端口被占用了,换个端口:

python manage.py runserver 8080

步骤 3:创建一个 App

我们的网站需要一个“首页”功能,所以新建一个叫 home 的 App:

python manage.py startapp home

然后在 mysite/settings.pyINSTALLED_APPS 列表里加上 'home'

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    # ... 其他默认项 ...
    'home',  # ← 加这一行!
]

步骤 4:写一个 View(视图)

打开 home/views.py,删掉原来的内容,写:

from django.http import HttpResponse

def welcome(request):
    return HttpResponse("<h1>你好!这是我的第一个Django网站!</h1>")

步骤 5:配置 URL 路由

现在要让访问首页时调用这个 welcome 函数。

先编辑 home/urls.py(如果不存在就新建):

from django.urls import path
from . import views

urlpatterns = [
    path('', views.welcome, name='welcome'),
]

再修改主路由 mysite/urls.py

from django.contrib import admin
from django.urls import path, include  # ← 注意引入 include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('home.urls')),  # ← 把 home 的路由接进来
]

步骤 6:刷新浏览器!

回到 http://127.0.0.1:8000,你应该看到大大的欢迎文字!

🧠 ChatGPT 如何帮你?
如果你卡在某一步,可以直接问 ChatGPT:“Django 中如何将 view 关联到首页 URL?” 它会给出清晰步骤和代码示例(记得核对版本!)。


五、新手常见问题 & 避坑指南

❓ 问题1:为什么改了代码页面没变?

Django 开发服务器会自动重载,但有时候缓存会导致没更新。试试:

  • 刷新浏览器(Ctrl+F5 强制刷新)
  • 重启 runserver

❓ 问题2:ImportError: No module named ‘xxx’

大概率是:

  • 忘记在 settings.pyINSTALLED_APPS 里注册 App
  • 文件名拼写错误(比如 view.py 写成 views.py

❓ 问题3:端口被占用怎么办?

lsof -i :8000(Mac/Linux)或 netstat -ano | findstr :8000(Windows)查出进程 ID,然后 kill 掉,或者直接换端口(见上文)。

⚠️ 避坑提醒:

  • 不要在项目名或路径中使用中文或空格!
  • 所有 .py 文件第一行不要加 #!/usr/bin/python(Windows 会报错)
  • 修改 settings.py 后必须重启服务器才生效

六、下一步怎么学?

你已经迈出了最难的第一步!接下来建议:

  1. 学模板(Templates):把 HTML 文件和 Django 结合,做出漂亮页面
  2. 玩转模型(Models):用 Django 自带的 ORM 操作数据库(不用写 SQL!)
  3. 尝试 Admin 后台:Django 自动生成的超级后台,5分钟搞定内容管理
  4. 部署上线:用 Railway 或 Vercel 免费把网站发布到互联网

🔥 我的建议:不要试图一次性学完所有概念!先做一个小项目(比如待办清单、留言板),边做边查,进步最快。


结语

看到这里,你已经比90%的观望者走得更远了。我当初学 Django 时,也是从一个“Hello World”页面开始的。技术没有魔法,只是一个个小步骤的累积。

如果你觉得这篇教程有帮助,欢迎去 B站 搜“阿杰coding”看我的视频版(有实时编码演示!)。也欢迎在评论区留言你的第一个网站截图,我会抽几位朋友送 Django 学习资料包!

记住:每个大神,都曾是小白。你离开发者,只差一个 runserver 的距离。

评论 0

最热最新
暂无评论
敏锐星空Lv.1
0
影响力
0
文章
0
粉丝