在 Windows 上，MySQL 程序按照指定的顺序从下表所示的文件中读取启动选项（首先读取列出的文件，后读取的文件优先）。

在上表中，%WINDIR%表示 Windows 目录的位置。这很常见 C:\WINDOWS。WINDIR使用以下命令根据环境变量 的值确定其确切位置 ：

C:\> echo %WINDIR%

%APPDATA%表示 Windows 应用程序数据目录的值。APPDATA使用以下命令根据环境变量 的值确定其确切位置 ：

C:\> echo %APPDATA%

BASEDIR表示 MySQL 基本安装目录。当使用 MySQL Installer 安装 MySQL 5.7 时，这通常 是 代表程序目录的位置（通常用于 Windows 的英文版本）。请参阅 第 2.3.3 节，“Windows 的 MySQL 安装程序”。 C:\PROGRAMDIR\MySQL\MySQL Server 5.7PROGRAMDIRProgram Files

在 Unix 和类 Unix 系统上，MySQL 程序按照指定的顺序从下表所示的文件中读取启动选项（首先读取列出的文件，后读取的文件优先）。

在上表中，~表示当前用户的主目录（ 的值 $HOME）。

SYSCONFDIR表示在构建 MySQL 时使用CMakeSYSCONFDIR 选项指定的目录。默认情况下，这是位于编译安装目录下的目录。 etc

MYSQL_HOME是一个环境变量，包含服务器特定my.cnf文件所在目录的路径。如果 MYSQL_HOME未设置并且您使用mysqld_safe程序启动服务器， 则mysqld_safe将其设置 BASEDIR为 MySQL 基本安装目录。

DATADIR很常见 /usr/local/mysql/data，尽管这可能因平台或安装方法而异。该值是编译MySQL时内置的数据目录位置，而不是 mysqld启动--datadir时用选项 指定的位置。在运行时使用 对服务器在处理任何选项之前查找它读取的选项文件的位置没有影响。 --datadir

如果找到给定选项的多个实例，则最后一个实例优先，但有一个例外：对于 mysqld，该选项的第一个 实例--user用作安全预防措施，以防止选项文件中指定的用户在命令行。

以下对选项文件语法的描述适用于您手动编辑的文件。这不包括 .mylogin.cnf，它是使用 mysql_config_editor创建的并且是加密的。

运行 MySQL 程序时在命令行上给出的任何长选项也可以在选项文件中给出。要获取程序的可用选项列表，请使用该--help选项运行它。（对于 mysqld，使用 --verbose和 --help。）

在选项文件中指定选项的语法类似于命令行语法（请参阅 第 4.2.2.1 节，“在命令行上使用选项”）。但是，在选项文件中，您从选项名称中省略了前导的两个破折号，并且每行仅指定一个选项。例如， 命令行上的--quickand应 在选项文件中--host=localhost 指定为 quick单独的行。host=localhost要 在选项文件中指定形式的选项，请将其写为 . --loose-opt_nameloose-opt_name

选项文件中的空行将被忽略。非空行可以采用以下任何形式：

选项名称和值中的前导和尾随空格会自动删除。

您可以在选项值中使用转义序列\b, \t, \n, \r,\\和 \s来表示退格符、制表符、换行符、回车符、反斜杠和空格字符。在选项文件中，这些转义规则适用：

前面的规则意味着文字反斜杠可以作为\\, 或者就\好像它后面没有跟一个有效的转义序列字符一样。

选项文件中的转义序列规则与 SQL 语句中字符串文字中的转义序列规则略有不同。在后一种情况下，如果 “ x”不是有效的转义序列字符， 则变为 “ ”而不是 。请参阅 第 9.1.1 节，“字符串文字”。 \xx\x

选项文件值的转义规则尤其适用于 \用作路径名分隔符的 Windows 路径名。Windows 路径名中的分隔符必须像\\ 其后跟转义序列字符一样书写。它可以写成\\或\不是。或者，/可以在 Windows 路径名中使用并被视为\. 假设您要 C:\Program Files\MySQL\MySQL Server 5.7在选项文件中指定一个基本目录。这可以通过多种方式完成。一些例子：

basedir="C:\Program Files\MySQL\MySQL Server 5.7"
basedir="C:\\Program Files\\MySQL\\MySQL Server 5.7"
basedir="C:/Program Files/MySQL/MySQL Server 5.7"
basedir=C:\\Program\sFiles\\MySQL\\MySQL\sServer\s5.7

如果选项组名称与程序名称相同，则组中的选项专门应用于该程序。例如，[mysqld]和[mysql] 组分别适用于mysqld服务器和 mysql客户端程序。

选项组由MySQL 发行版中提供 的[client]所有客户端程序读取（但 不由mysqld读取）。要了解使用 C API 的第三方客户端程序如何使用选项文件，请参阅 mysql_options()中的 C API 文档。

该[client]组使您能够指定适用于所有客户端的选项。例如， [client]是用于指定连接到服务器的密码的适当组。（但要确保选项文件只能由您自己访问，这样其他人就无法发现您的密码。）确保不要将选项放在[client]组中，除非您使用的所有客户端程序都可以识别它。如果您尝试运行不理解该选项的程序，则会在显示错误消息后退出。

先列出更通用的选项组，然后再列出更具体的选项组。例如，一个[client]组更通用，因为它被所有客户端程序读取，而一个[mysqldump]组只被 mysqldump读取。后面指定的选项会覆盖前面指定的选项，因此将选项组按顺序排列[client]， [mysqldump]使 mysqldump特定的选项能够覆盖 [client]选项。

这是一个典型的全局选项文件：

[client]
port=3306
socket=/tmp/mysql.sock

[mysqld]
port=3306
socket=/tmp/mysql.sock
key_buffer_size=16M
max_allowed_packet=8M

[mysqldump]
quick

这是一个典型的用户选项文件：

[client]
# The following password is sent to all standard MySQL clients
password="my password"

[mysql]
no-auto-rehash
connect_timeout=2

要创建仅供来自特定 MySQL 版本系列的 mysqld服务器读取的选项组，请使用名称为 [mysqld-5.6]、 [mysqld-5.7]等的组。以下组表示该 sql_mode设置只能由版本号为 5.7.x 的 MySQL 服务器使用：

[mysqld-5.7]
sql_mode=TRADITIONAL

可以!include在选项文件中使用指令来包含其他选项文件并 !includedir在特定目录中搜​​索选项文件。例如，要包含 /home/mydir/myopt.cnf文件，请使用以下指令：

!include /home/mydir/myopt.cnf

要搜索/home/mydir目录并读取在那里找到的选项文件，请使用此指令：

!includedir /home/mydir

MySQL 不保证目录中选项文件的读取顺序。

像任何其他选项文件一样写入包含的选项文件的内容。也就是说，它应该包含选项组，每个选项前面都有 一行指示选项适用的程序。 [group]

在处理包含的文件时，仅使用当前程序正在查找的组中的那些选项。其他组被忽略。假设一个 my.cnf文件包含这一行：

!include /home/mydir/myopt.cnf

假设它/home/mydir/myopt.cnf 看起来像这样：

[mysqladmin]
force

[mysqld]
key_buffer_size=16M

如果my.cnf由 mysqld处理，则仅使用 [mysqld]组 in /home/mydir/myopt.cnf。如果文件由mysqladmin处理，则仅使用 [mysqladmin]组。如果文件由任何其他程序处理，则不 /home/mydir/myopt.cnf使用任何选项。

除了读取指定目录中的所有选项文件外，该!includedir指令的处理方式类似。

如果选项文件包含!include或 !includedir指令，则只要处理选项文件，就会处理由这些指令命名的文件，无论它们出现在文件中的什么位置。

为了使包含指令起作用，文件路径不应在引号内指定，并且不应包含转义序列。例如， my.ini读取选项文件 中提供的以下语句myopts.ini：

!include C:/ProgramData/MySQL/MySQL Server/myopts.ini
!include C:\ProgramData\MySQL\MySQL Server\myopts.ini
!include C:\\ProgramData\\MySQL\\MySQL Server\\myopts.ini

在 Windows 上，如果是文件中的最后一行，请确保在末尾附加换行符或忽略该行。 !include /path/to/extra.ini