企业官网建设流程全解析

简介：这份《MYSQL电子书中文》面向数据库初学者与有一定经验的开发者，系统梳理MySQL核心概念、功能与最佳实践，帮助读者从建库建表到性能调优逐步建立完整知识体系。资源包共38个文件，全部为html格式，压缩包约1.32MB，按章节与附录组织，涵盖基础SQL操作、数据类型与InnoDB、MyISAM存储引擎对比、索引创建与管理、EXPLAIN查询分析，以及触发器、存储过程、视图等高级主题。内容还延伸至数据库设计与优化，包括范式理论、高效SQL编写与参数调整，并涉及mysqldump备份恢复、性能指标监控和用户权限与数据加密等安全实践。目前已有514人学习，适合希望系统掌握MySQL管理与开发技能、为项目或业务提供数据支撑的读者按章节查阅与练习。

1. 从「MYSQL电子书中文」说起：一份能落地的中文知识库该长什么样

很多人搜「MYSQL电子书中文」，其实不是想找一本排版精美的 PDF，而是想要一份能随时查、能全文检索、能跟着敲命令的中文 MySQL 知识库。市面上的电子书要么是扫描版没法复制 SQL，要么是英文原版术语劝退，要么版本停在 5.7 却讲着 8.0 的语法。我做过几套内部用的 MySQL 中文手册，最后都收敛到同一个方案：用 Markdown 写正文，用 Pandoc 转成 EPUB 和 PDF，用 Git 管版本，用全文检索工具做索引。这套流程的好处是内容可维护、格式可切换、中文排版不翻车。这一章先说清楚它解决什么问题、适合谁，后面几章拆开讲怎么搭、参数怎么调、坑在哪。

适合的读者有三类：一是团队里要维护内部数据库规范文档的人，二是想给自己整理一份 MySQL 速查手册的开发者，三是需要把零散笔记变成可分发电子书的运维。核心诉求都一样——中文内容要能搜、能复制、能离线看，还要跟得上 MySQL 8.0 之后的语法变化。下面从内容组织讲到工具链，每一步都给可复现的命令和参数。

2. 中文 MySQL 电子书的内容骨架：章节怎么切、代码怎么存

2.1 为什么按「命令域」而不是按「知识点」分章

我见过不少中文 MySQL 资料按「基础篇、进阶篇、实战篇」分，结果查一个EXPLAIN要翻三个地方。更实用的切法是按命令域：安装与连接、库表操作、索引与执行计划、事务与锁、存储过程与函数、备份恢复、性能排查。每个域下面再分「语法速查」「参数说明」「常见报错」。这样做的直接好处是全文检索时命中率高——你搜mysql锁的分类，能直接落到「事务与锁」那一章的锁类型表格，而不是散落在各处的段落。

内容来源上，我一般把官方文档的中文页、自己踩过的报错记录、以及项目里真实用过的 SQL 片段混编。注意不要直接复制官方文档全文，一是版权，二是官方中文有些翻译读起来别扭。我的做法是：官方语法部分保留英文关键字，解释用中文重写，每个命令配一个能在本地跑通的最小示例。比如讲mysql排序，不要只写ORDER BY语法，要给一张有数据的表、一条带LIMIT的排序语句、以及ORDER BY走不走索引的对比。

2.2 用 Markdown 组织内容：目录结构与代码块规范

目录结构建议这样：

mysql-handbook-zh/ ├── docs/ │ ├── 01-install.md │ ├── 02-crud.md │ ├── 03-index.md │ ├── 04-transaction-lock.md │ ├── 05-procedure-function.md │ ├── 06-backup-restore.md │ └── 07-performance.md ├── assets/ │ └── images/ ├── metadata.yaml └── build.sh

每个 md 文件里，代码块统一用sql标注，报错信息用text，命令行用bash。这样做是为了后面 Pandoc 转换时能正确高亮。代码块里只放能直接执行的语句，不要放伪代码。比如讲存储过程：

-- 创建一个按用户 ID 查订单数量的存储过程 DELIMITER $$ CREATE PROCEDURE get_order_count(IN uid INT, OUT cnt INT) BEGIN SELECT COUNT(*) INTO cnt FROM orders WHERE user_id = uid; END $$ DELIMITER ; -- 调用并查看结果 CALL get_order_count(1001, @c); SELECT @c;

逻辑说明：DELIMITER是为了让 MySQL 客户端把;当成过程体内部的分隔符，而不是语句结束符。参数说明：IN uid是输入参数，OUT cnt是输出参数，调用时用用户变量@c接收。这个例子能直接跑，前提是orders表存在且有user_id字段。写电子书时，每个代码块后面都要跟一段这样的说明，否则读者复制过去报错都不知道错在哪。

2.3 中文排版的两个硬约束：字体与换行

Markdown 本身不处理中文换行，转 PDF 时如果字体没配好，会出现方块字或者行距诡异。我的经验是：正文用思源宋体或 Noto Serif CJK，代码用等宽字体如 JetBrains Mono 或 Sarasa Mono SC。Pandoc 转 PDF 时通过--pdf-engine=xelatex加mainfont参数指定。另外中文段落不要手动加换行，让渲染引擎自己折行，否则转 EPUB 后会出现奇怪的断句。这些细节在下一章的构建脚本里会具体给参数。

3. 用 Pandoc 把 Markdown 转成中文 EPUB 和 PDF：命令与参数

3.1 安装 Pandoc 与 LaTeX 环境的最小步骤

Windows 上直接下 Pandoc 的 msi 安装包，装完pandoc --version能出版本号即可。转 PDF 需要 LaTeX，推荐装 MiKTeX 或 TeX Live，装的时候勾选中文支持包。Linux 上用包管理器：

# Debian/Ubuntu 系 sudo apt update sudo apt install pandoc texlive-xetex texlive-lang-chinese fonts-noto-cjk # 验证 pandoc --version xelatex --version

参数说明：texlive-xetex提供 xelatex 引擎，texlive-lang-chinese提供中文断行和标点处理，fonts-noto-cjk是字体。装完如果xelatex找不到，检查 PATH 里有没有 TeX Live 的 bin 目录。这一步翻车的常见原因是只装了 Pandoc 没装 LaTeX，转 PDF 时报xelatex not found。

3.2 转 EPUB 的命令与 metadata 配置

EPUB 适合手机和阅读器，转换命令简单，但中文元数据要单独配。先写一个metadata.yaml：

--- title: "MySQL 中文实战手册" author: "你的名字" lang: zh-CN date: "2025-01-01" rights: "内部资料" ---

然后执行：

pandoc docs/*.md \ --metadata-file=metadata.yaml \ --toc \ --toc-depth=2 \ --split-level=1 \ -o mysql-handbook-zh.epub

逻辑说明：--toc生成目录，--toc-depth=2表示目录只到二级标题，--split-level=1表示每个一级标题拆成一个 EPUB 章节文件。参数说明：lang: zh-CN很关键，它决定阅读器用哪套断行规则；不写的话有些阅读器会把中文当英文处理，标点位置会错。转完用 Calibre 或手机阅读器打开检查目录和代码块高亮。

3.3 转 PDF 的中文字体参数与页边距

PDF 适合打印和归档，命令稍长：

pandoc docs/*.md \ --metadata-file=metadata.yaml \ --pdf-engine=xelatex \ -V mainfont="Noto Serif CJK SC" \ -V monofont="JetBrains Mono" \ -V geometry:margin=2.5cm \ -V fontsize=11pt \ --toc \ -o mysql-handbook-zh.pdf

逻辑说明：-V是传给 LaTeX 模板的变量。mainfont指定正文中文字体，monofont指定代码字体，geometry:margin控制页边距，fontsize控制字号。参数说明：如果mainfont名字写错，xelatex 会报找不到字体，用fc-list :lang=zh查系统里可用的中文字体名。页边距 2.5cm 是打印装订的安全值，纯屏幕看可以调到 2cm。转出来的 PDF 如果代码块溢出页面，把fontsize降到 10pt 或者给代码块加--listings参数。

3.4 构建脚本：一条命令出两种格式

把上面两步写进build.sh：

#!/usr/bin/env bash set -e META="metadata.yaml" SRC="docs/*.md" # 生成 EPUB pandoc $SRC --metadata-file=$META --toc --toc-depth=2 \ --split-level=1 -o dist/mysql-handbook-zh.epub # 生成 PDF pandoc $SRC --metadata-file=$META --pdf-engine=xelatex \ -V mainfont="Noto Serif CJK SC" \ -V monofont="JetBrains Mono" \ -V geometry:margin=2.5cm \ -V fontsize=11pt --toc -o dist/mysql-handbook-zh.pdf echo "构建完成"

逻辑说明：set -e让脚本遇到错误立即停止，避免生成半成品。参数说明：dist/目录要先mkdir -p dist，否则 Pandoc 报路径不存在。这个脚本在 CI 里也能跑，配合 Git 提交自动出最新版电子书。注意 Windows 上用 Git Bash 跑，路径分隔符别用反斜杠。

4. 让中文电子书可检索：全文索引与 MySQL 文档联动

4.1 用 ripgrep 做本地全文检索

电子书生成后，最实用的功能是全文检索。Markdown 源文件用ripgrep搜最快：

# 搜所有提到「锁」的段落，显示文件名和行号 rg -n "锁" docs/ # 只搜 SQL 代码块里的内容 rg -n --type-add 'sql:*.md' -t sql "SELECT.*FOR UPDATE" docs/

逻辑说明：-n显示行号，--type-add自定义文件类型把 md 当 sql 搜。参数说明：rg默认忽略.gitignore里的文件，如果 docs 被忽略要加--no-ignore。这个方式适合写作者自己查重和找遗漏，不适合最终读者。给读者用的检索要么靠 EPUB 阅读器自带搜索，要么单独做一个静态站点。

4.2 把 MySQL 官方文档关键词映射到自己的章节

写中文手册时，读者经常拿官方英文术语来搜。可以在每章开头加一个「关键词映射」小表：

这样搜mysql锁的分类或mysql存储过程都能落到对应章节。表格放在每章开头，Pandoc 转 EPUB 时会保留，阅读器搜索表格内容也能命中。

4.3 用 MySQL 自身存文档元数据做检索

如果手册章节多了，可以建一张表存章节标题和关键词，用 MySQL 的全文索引来搜：

CREATE TABLE handbook_toc ( id INT PRIMARY KEY AUTO_INCREMENT, chapter VARCHAR(100), keywords VARCHAR(255), file_path VARCHAR(255), FULLTEXT KEY ft_kw (chapter, keywords) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; INSERT INTO handbook_toc (chapter, keywords, file_path) VALUES ('索引与执行计划', 'EXPLAIN 索引 执行计划 慢查询', 'docs/03-index.md'), ('事务与锁', '事务 锁 隔离级别 死锁', 'docs/04-transaction-lock.md'); -- 搜关键词 SELECT chapter, file_path FROM handbook_toc WHERE MATCH(chapter, keywords) AGAINST('锁' IN NATURAL LANGUAGE MODE);

逻辑说明：FULLTEXT索引在 InnoDB 里对中文支持一般，需要配合ngram分词器。参数说明：建表时CHARSET=utf8mb4保证中文不乱码；如果搜中文效果差，加WITH PARSER ngram。这个方案适合团队内部做文档导航页，不适合直接给最终读者。

5. 避坑与排查：中文电子书构建的 5 个血泪记录

5.1 现象：PDF 里中文全是方块

原因：xelatex 没找到中文字体，或者mainfont写的是英文字体名。解决：用fc-list :lang=zh列出系统可用中文字体，把mainfont改成列表里存在的名字，比如Noto Serif CJK SC或Source Han Serif SC。如果系统没装中文字体，先apt install fonts-noto-cjk。

5.2 现象：EPUB 目录里章节顺序乱了

原因：pandoc docs/*.md的通配符展开顺序依赖文件名，如果文件名是1-install.md、10-performance.md、2-crud.md，字典序会把 10 排在 2 前面。解决：文件名统一用两位数前缀，如01-install.md、02-crud.md，或者显式按顺序列出文件。我一般用两位数，省事。

5.3 现象：代码块里的中文注释转 PDF 后变成乱码

原因：monofont指定的等宽字体不含中文字形。解决：换一个带中文的等宽字体，比如Sarasa Mono SC，或者给代码块单独设CJKmonofont。Pandoc 的 LaTeX 模板里可以用-V CJKmonofont="Sarasa Mono SC"。如果找不到合适字体，把代码里的中文注释改成英文，正文里再用中文解释。

5.4 现象：MySQL 存储过程示例复制到客户端报DELIMITER错误

原因：有些图形化客户端（如某些版本的 Navicat）不认DELIMITER，或者把整段当成一条语句。解决：在电子书里注明「以下示例适用于命令行客户端 mysql，图形化工具请去掉 DELIMITER 行并逐段执行」。或者改用CREATE PROCEDURE不带DELIMITER的写法，但那样只能通过 API 调用。我一般在代码块前加一句提示，减少读者翻车。

5.5 现象：全文检索搜不到中文关键词

原因：ripgrep默认按字节匹配，中文没问题，但如果文件编码是 GBK 就会乱。解决：所有 md 文件统一存成 UTF-8 无 BOM。VS Code 右下角可以看编码，Pycharm 在 File Encoding 里设。另外 MySQL 全文索引搜中文要加ngram解析器，否则按空格分词，中文整段被当成一个词。

6. 进阶：用 Git 管版本、用 CI 自动出中文电子书

内容多了以后，手动跑build.sh容易忘。我的习惯是把电子书项目放进 Git，每次改完 md 提交，CI 自动构建 EPUB 和 PDF 并归档。以 GitHub Actions 为例：

name: build-handbook on: push: branches: [main] jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Install deps run: | sudo apt update sudo apt install -y pandoc texlive-xetex texlive-lang-chinese fonts-noto-cjk - name: Build run: | mkdir -p dist bash build.sh - name: Upload uses: actions/upload-artifact@v4 with: name: mysql-handbook-zh path: dist/

逻辑说明：push 到 main 触发，装依赖后跑构建脚本，最后把dist/里的文件作为 artifact 上传。参数说明：actions/upload-artifact@v4的path指向产物目录，name是 artifact 名。这样每次提交都能拿到最新电子书，不用本地装 LaTeX。注意 CI 里字体包要显式装，否则 PDF 中文会翻车。

验证构建结果是否正常，我一般做三件事：一是用epubcheck检查 EPUB 结构，二是用pdffonts看 PDF 里中文字体是否嵌入，三是随机抽三个代码块在本地 MySQL 跑一遍。pdffonts mysql-handbook-zh.pdf输出里如果中文字体那一列显示yes，说明嵌入成功，换设备不会乱码。

最后一个习惯：每章末尾留一个「最后验证日期」和「适用 MySQL 版本」，因为 MySQL 8.0 到 8.4 之间语法有变化，读者看到旧内容会踩坑。我吃过亏，一份 5.7 时代的手册被新人拿去装 8.0，mysql_install_db命令已经没了，折腾半天。现在每篇文档头部都写清楚版本，省得后人翻车。希望帮到你。

本文还有配套的精品资源，点击获取