MySQL 按照以下讨论中描述的顺序查找选项文件，并读取存在的任何文件。如果您要使用的选项文件不存在，请使用刚刚讨论的适当方法创建它。

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

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

C:\> echo %WINDIR%

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

C:\> echo %APPDATA%

BASEDIR 表示 MySQL 基本安装目录。使用 MSI 安装 MySQL 9.0 时，这通常是 C:\PROGRAMDIR\MySQL\MySQL Server 9.0，其中 PROGRAMDIR 表示程序目录（对于英文版本的 Windows，通常是 Program Files）。

DATADIR 表示 MySQL 数据目录。用于查找 mysqld-auto.cnf 时，其默认值是编译 MySQL 时内置的数据目录位置，但可以通过在处理 mysqld-auto.cnf 之前处理的选项文件或命令行选项中指定的 --datadir 进行更改。

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

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

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

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

DATADIR 表示 MySQL 数据目录。用于查找 mysqld-auto.cnf 时，其默认值是编译 MySQL 时内置的数据目录位置，但可以通过在处理 mysqld-auto.cnf 之前处理的选项文件或命令行选项中指定的 --datadir 进行更改。

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

以下选项文件语法说明适用于您手动编辑的文件。这不包括使用 mysql_config_editor 创建并加密的 .mylogin.cnf，以及服务器以 JSON 格式创建的 mysqld-auto.cnf。

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

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

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

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

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

前面的规则意味着字面反斜杠可以写为 \\，如果它后面没有有效的转义序列字符，则可以写为 \。

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

选项文件值的转义规则尤其适用于 Windows 路径名，它们使用 \ 作为路径名分隔符。如果 Windows 路径名中的分隔符后跟转义序列字符，则必须将其写为 \\。如果它后面没有转义序列字符，则可以将其写为 \\ 或 \。或者，可以在 Windows 路径名中使用 /，并且将其视为 \。假设您要在选项文件中指定基本目录 C:\Program Files\MySQL\MySQL Server 9.0。这可以通过几种方式完成。一些例子

basedir="C:\Program Files\MySQL\MySQL Server 9.0"
basedir="C:\\Program Files\\MySQL\\MySQL Server 9.0"
basedir="C:/Program Files/MySQL/MySQL Server 9.0"
basedir=C:\\Program\sFiles\\MySQL\\MySQL\sServer\s9.0

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

[client] 选项组由 MySQL 发行版中提供的所有客户端程序读取（但不是由 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=128M

[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-8.4]、[mysqld-9.0] 等的组。以下组指示 sql_mode 设置应仅由版本号为 9.0.x 的 MySQL 服务器使用

[mysqld-9.0]
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

如果 mysqld 正在处理 my.cnf，则只会使用 /home/mydir/myopt.cnf 中的 [mysqld] 组。如果 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 是文件中的最后一行，请确保在末尾附加一个换行符；否则，该行将被忽略。