手把手教你看MySQL官方文档

前言：

在学习和使用MySQL的过程中，难免会遇到各种问题。不知道当你遇到相关问题时会怎么做，我在工作或写文章的过程中，遇到不懂或需要求证的问题时通常会去查阅官方文档。慢慢的，阅读文档也有了一些经验，本篇文章将手把手教你阅读MySQL官方文档，希望可以给到各位一点小收获。

1.初识官方文档

如果你还没有仔细的看过MySQL官方文档，可以跟着我一步步体验下哦。首先打开参考文档首页，这里以5.7版本为例，首页地址：https://dev.mysql.com/doc/refman/5.7/en/

首页左侧边是目录，目录上方有个搜索框，首页右上角可以切换版本，比如你想看8.0版本的话可以切换到对应版本。接下来我们认识下目录内容，从侧边目录栏可以看出参考手册按照分类分为不同章节，建议大家首先阅读下第一章节General Information，该章节的主要内容如下：

• 关于该参考手册的使用方法及适用版本。
• 介绍MySQL的历史及数据库系统概述。
• 列出5.7版本新增的功能。
• 介绍5.7版本新增及不建议使用的一些参数变量。

可以看出，第一章节从整体上介绍了该版本MySQL相关的内容，读读第一章有助于我们更好的使用此文档。下面目录中比较重要的章节有安装和升级、MySQL服务管理、备份与恢复、优化、字段类型、SQL语句、InnoDB存储引擎、主从复制等。至此，我们大概认识了MySQL官方文档，下面继续看下该如何使用。

2.读活的文档

一般情况下，我们都是遇到问题或者有想知道的知识时，会去翻阅官方文档。此时我们是带着目标去阅读的，这种情况下应该速战速决。如果你对该文档目录很熟悉，那么可以很快找到相关内容，如果你对文档不熟悉，这时候要善用搜索，比如你想了解如何创建索引，在搜索框输入index，然后即可搜索出索引相关章节。

有的同学可能说了，这文档都是英文也看不太懂啊。其实我想说，参考文档中的英文大多是浅显易懂的，通读一遍能大概知道什么意思，实在看不懂可以借助谷歌翻译或其他插件进行翻译。推荐大家开两个相同的标签页，一个英文另一个借助浏览器翻译成中文，这样可以两边对照着阅读。

我们应该读“活”的文档，阅读文档要灵活运用，推荐边阅读边测试。同时也要读全面，有的参数变量在不同版本可能表现不同。不建议毫无目的的去阅读文档，推荐有计划的阅读，比如说你想了解InnoDB引擎，那么你可以根据自己的时间安排阅读InnoDB存储引擎这一章节。

3.几个小技巧

除了上面善用搜索框搜索的技巧外，下面再分享几个小技巧。不知道你有没有遇到过这种情况，就是某个语法你以前用过，但这次写着写着却发现想不起来了。此时你可以去网上搜索或翻阅官方文档，但更简便的做法是利用命令行自带的帮助文档，比如说你想了解create database参数，直接在MySQL命令行输入 ? create database 即可，命令行会自动输出相关内容并且给出文档链接，是不是方便了很多。

mysql> ? create database 
Name: 'CREATE DATABASE'
Description:
Syntax:
CREATE {DATABASE | SCHEMA} [IF NOT EXISTS] db_name
    [create_specification] ...

create_specification:
    [DEFAULT] CHARACTER SET [=] charset_name
  | [DEFAULT] COLLATE [=] collation_name

CREATE DATABASE creates a database with the given name. To use this
statement, you need the CREATE privilege for the database. CREATE
SCHEMA is a synonym for CREATE DATABASE.

URL: http://dev.mysql.com/doc/refman/5.7/en/create-database.html

MySQL文档中有很多语句示例，其中也有些规范，比如说以上面create database语句为例，中括号[]中的内容可以省略，花括号{}中的内容是任选其一的，不同选项以竖线|分隔。了解这些有助于我们快速明白相关语句用法。

其实除了MySQL官方文档外，MySQL官方还提供了其他各种网络资源，下面简单介绍下：

社区版下载网站：
https://dev.mysql.com/downloads/

版本发行说明手册，其中有各版本新增内容：
https://dev.mysql.com/doc/relnotes/mysql/5.7/en/
https://dev.mysql.com/doc/relnotes/mysql/8.0/en/

查看与提交bug网站：
https://bugs.mysql.com/

MySQL团队博客：
https://mysqlserverteam.com/

总结：

还在学习MySQL的同学要多多翻阅官方文档，官方文档中的内容才是最全面准确的。本篇文章我将自己阅读文档的经验和技巧都分享出来了，希望对你有所帮助。写这篇文章费了笔者很大的精力，还请各位小伙伴多多支持哈！

本文由博客一文多发平台 OpenWrite 发布！