/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */
#content_views .toc,
/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */
#content_views.markdown_views > p:empty:has(+ .toc),
#content_views.markdown_views > .toc + p:empty,
/* 富文本旧版目录标记 */
#content_views.htmledit_views #main-toc,
#content_views.htmledit_views #hr-toc,
#content_views.htmledit_views p[id*=\”-toc\”] {
display: none !important;
}
/* 目录去掉后,紧跟的首个标题不再多出一块上边距 */
#content_views.markdown_views > .toc + h1,
#content_views.markdown_views > .toc + h2,
#content_views.markdown_views > .toc + h3,
#content_views.markdown_views > .toc + h4,
#content_views.markdown_views > .toc + p:empty + h1,
#content_views.markdown_views > .toc + p:empty + h2,
#content_views.markdown_views > .toc + p:empty + h3,
#content_views.markdown_views > .toc + p:empty + h4 {
margin-top: 0 !important;
}
第 10 章 MySQL:把数据放进真正的数据库
本章版本:v1.0 本章产出:sql/schema.sql、src/db.js、src/repositories/mysqlTodoRepository.js、scripts/init-db.js
本章目标:安装并启动 MySQL,建库建表,用 mysql2 连接池实现 CRUD,理解占位符、字段映射和存储切换。
图 10-1 · 换的是仓库实现,不是业务接口
10.1 JSON 文件的退休申请
第九周第一节课,李老师在讲台上放了一个纸盒子,上面写着“data/todos.json 退休欢送会”。
“先给它记一功。”他说,“从第 6 章到今天,它扛住了你们所有的数据,让每个人体验了持久化。但它有两个治不了的病:”
第一,每次读写都要操作整个文件。 哪怕只查一条待办,也要把整个 JSON 读进来、JSON.parse 成数组、再 find。数据量到几万条,内存和 CPU 都吃不消。
第二,不支持复杂查询。“想查‘所有未完成的待办,按创建时间倒序,只取前 20 条’,怎么办?”
“先读全量,再 filter,再 sort,再 slice。”林雪霸背得出来。
“对,全量。数据库就是为这两个问题生的。今天选 MySQL——全球最流行的关系型数据库之一,学校环境、企业项目里都非常常见。”
对比表
| 数据单位:整个文件 | 表(table) |
| 数据行:数组元素 | 行(row) |
| 字段:对象属性 | 列(column) |
| 主键:手动生成 | AUTO_INCREMENT 自增 |
| 查询:读全量再过滤 | SQL 条件查询、索引 |
| 并发:容易冲突 | 事务、锁、连接池 |
一条待办在 MySQL 里长这样:
| 1 | 学习 MySQL | 0 | 2026-10-09 08:00:00 |
| 2 | 完成项目 | 1 | 2026-10-09 09:00:00 |
“completed 用 0/1 表示布尔值,created_at 记录创建时间。”李老师说,“注意,这不是‘JSON 的敌人’,是 JSON 的进化形态——数据还是那些数据,只是住进了有物业的房子。”
10.2 安装与启动 MySQL
“安装方式三选一。”
方式一:本地安装 MySQL Community Server(推荐)。
- 访问 https://dev.mysql.com/downloads/mysql/,选择操作系统,下载 Community Server。
- Windows 安装时选 “Developer Default” 或 “Server only”,设置 root 密码,记住它。
- macOS 用 Homebrew:
brew install mysql
brew services start mysql
- Linux(Ubuntu/Debian):
sudo apt update
sudo apt install mysql-server
sudo systemctl start mysql
方式二:XAMPP / WAMP(适合 Windows)。 装好打开 Control Panel 启动 MySQL,默认 root 密码为空,端口 3306。
验证:
mysql -u root -p
看到 mysql> 提示符就成功了,exit 退出。
“如果提示 mysql 不是内部或外部命令,”李老师看向陈金宝。
“PATH。”陈金宝条件反射。
“对。把 MySQL 的 bin 目录加进 PATH,或者用 MySQL Workbench 图形化工具,或者用完整路径执行。”
检查服务(Windows):
Get-Service | Where-Object {
$_.Name -like \’*mysql*\’ }
Start-Service MySQL80
“服务名可能是 MySQL80、MySQL 或 mysql,以实际为准。”
10.3 建库建表:一行一行讲
登录 MySQL 后执行:
CREATE DATABASE IF NOT EXISTS todo_app
DEFAULT CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;
USE todo_app;
CREATE TABLE IF NOT EXISTS todos (
id INT UNSIGNED NOT NULL AUTO_INCREMENT,
title VARCHAR(255) NOT NULL,
completed TINYINT(1) NOT NULL DEFAULT 0,
created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3)
ON UPDATE CURRENT_TIMESTAMP(3),
PRIMARY KEY (id),
KEY idx_todos_completed_created (completed, created_at)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
INSERT INTO todos (title, completed) VALUES
(\’学习 Node.js\’, 0),
(\’完成项目立项\’, 1),
(\’复习 MySQL\’, 0);
SELECT * FROM todos;
“逐行提问时间。”
- id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY:无符号整数,自增主键。UNSIGNED 表示不允许负数,范围更大。
- title VARCHAR(255) NOT NULL:第 1 章说的“数据库层保险”,现在兑现了。
- completed TINYINT(1) NOT NULL DEFAULT 0:MySQL 的 BOOLEAN 是 TINYINT(1) 的别名。
- created_at DATETIME(3) DEFAULT CURRENT_TIMESTAMP(3):创建时自动填当前时间,3 位毫秒。
- updated_at … ON UPDATE CURRENT_TIMESTAMP(3):每次更新行自动刷新。“**就算你的业务代码忘了写 updated_at,数据库也会替你维护。**多一道保险,少一次事故。”
- KEY idx_todos_completed_created (completed, created_at):联合索引,加速“按状态筛选 + 按时间排序”——正好是你们列表页的查询形状。
- ENGINE=InnoDB:支持事务、行锁、外键。
- CHARSET=utf8mb4:支持中文和 emoji。
“为什么不是 utf8?”关羽问。
“MySQL 的 utf8 最多 3 字节,emoji 是 4 字节,会直接报错。”李老师说,“别用 utf8,用 utf8mb4——名字少一个字母,能力差一截,这是 MySQL 历史遗留的最大冷笑话。”
为什么时间用 UTC
“created_at 存 UTC,不存本地时间。服务器迁移到不同时区,数据不错乱;展示时再转本地时区。”
“在 Node.js 里,我们通过 mysql2 的 timezone: \’Z\’ 告诉驱动‘数据库里的时间按 UTC 解释’,读出来就是正确的 Date,再 toISOString() 返回前端。”
用脚本初始化
“手动执行 SQL 容易漏、容易忘。项目里提供 npm run db:init。”
scripts/init-db.js:
const mysql = require(\’mysql2/promise\’);
const config = require(\’../src/config\’);
async function main() {
const {
database } = config.db;
if (!/^[A-Za-z0-9_]+$
网硕互联帮助中心


评论前必须登录!
注册