一、课程导学与项目全景：话题发布器是什么？我们能学到什么？开发环境总览

各位同学，欢迎来到《手把手教你写第一个话题发布器》的第一课。

说实话，我见过太多新手学编程，一上来就啃语法书，啃到一半就放弃了。为什么？因为太枯燥了。你想想看，学了半个月的变量、循环、函数，结果连个能用的东西都做不出来，换谁都没劲。

所以这门课不一样。咱们直接上手做一个真实的小项目——话题发布器。做完它，你就能理解一个完整的 Web 应用是怎么跑起来的。

1.1 话题发布器到底是什么？

说白了，就是一个让你能发帖子的小网站。

你打开页面，输入一个标题，写一段内容，点一下「发布」按钮，这条信息就存到数据库里了。别人打开这个网站，就能看到你发的所有话题。

听起来很简单对吧？但麻雀虽小，五脏俱全。它包含了 Web 开发最核心的几个环节：

• 前端页面（用户能看到的部分）
• 后端接口（处理请求的逻辑）
• 数据库（存数据的地方）
• 部署上线（让别人也能访问）

我在带新人时发现，很多人对「前后端怎么配合」特别迷糊。这个项目就是帮你打通这层窗户纸。

1.2 我们能学到什么？

这门课一共 30 章，每章解决一个具体问题。我挑几个重点说说：

1.2.1 从零搭建项目骨架

你会学会怎么用 Flask 创建一个 Web 应用。不是那种「照着敲一遍」的学，而是理解每一行代码为什么这么写。

我记得第一次带徒弟时，他问我：「为什么要把路由写在单独的文件里？」嗯，这个问题问得好。等你做到第 5 章，自然就明白了——不拆分的话，代码会乱成一锅粥。

1.2.2 数据库操作实战

我们会用 SQLite 存数据。你可能会问：「为什么不用 MySQL？」因为 SQLite 不需要安装，一个文件就能跑。对于学习阶段来说，够用了。

你会学到：

• 建表、增删改查
• 防止 SQL 注入（这个很重要，我曾经见过有人直接把用户输入拼到 SQL 里，结果被删了库）
• 用 ORM 简化操作

1.2.3 前端交互

虽然咱们不是前端课，但基本的 HTML 表单、列表展示、CSS 样式你得会。我会教你用 Bootstrap 快速搭一个好看的页面。

别怕，不需要你成为 CSS 大师。能看懂、能改、能用，就够了。

1.3 开发环境总览

工欲善其事，必先利其器。咱们先把开发环境搭好。

1.3.1 你需要安装什么？

工具	版本建议	说明
Python	3.8+	推荐 3.10，稳定且兼容性好
VS Code	最新版	轻量级编辑器，插件丰富
Git	2.x	版本控制，建议装
Flask	2.x	Python 的 Web 框架

1.3.2 我的个人习惯

我建议你用虚拟环境。为什么？因为不同项目可能依赖不同版本的包，混在一起会出问题。

我曾经在一个项目里同时用了 Flask 1.x 和 2.x，结果调试了一整天，最后发现是版本冲突。从那以后，每个项目我都单独建虚拟环境。

创建虚拟环境的命令很简单：

# 创建虚拟环境
python -m venv venv

# 激活（Windows）
venv\Scripts\activate

# 激活（Mac/Linux）
source venv/bin/activate

# 安装 Flask
pip install flask

1.3.3 项目结构预览

咱们最终的项目结构大概长这样：

topic_publisher/
├── app.py              # 主入口
├── models.py           # 数据库模型
├── routes.py           # 路由（接口）
├── templates/          # HTML 模板
│   ├── index.html
│   └── publish.html
├── static/             # 静态文件（CSS、JS）
│   └── style.css
├── requirements.txt    # 依赖列表
└── venv/               # 虚拟环境

别被这么多文件吓到。咱们是一步一步建起来的，每章只加一点点东西。

1.4 本章知识体系

下面这张图帮你理清整个课程的知识脉络：

1.5 本章小结

好，咱们捋一下这章讲了什么：

• 话题发布器是一个能发帖、看帖的小网站
• 你会学到 Python、Flask、HTML、SQLite 的综合运用
• 开发环境需要 Python 3.8+、VS Code、Git、Flask
• 建议用虚拟环境隔离依赖

下一章，咱们就开始动手写代码了。我会带着你从第一行代码开始，一步步搭起这个项目。

准备好了吗？咱们第二章见。