my.ini是MySQL在Windows系统下的核心配置文件，所有数据库的启动参数、运行规则都可以通过该文件进行自定义调整，合理的配置能够大幅提升数据库的稳定性和运行效率。
my.ini文件的基础位置
不同安装方式下my.ini的默认存放路径存在差异：
- 使用MySQL官方安装包默认安装时，文件通常位于C:ProgramDataMySQLMySQL Server 8.0目录下，注意ProgramData是隐藏文件夹，需要开启显示隐藏文件选项才能看到。
- 如果是解压版MySQL，my.ini一般和bin目录同级，位于解压后的根目录中，如果根目录没有该文件，可以手动新建。
- 也可以通过MySQL命令行查询当前加载的配置文件路径，执行以下命令即可：
-- 查看MySQL当前加载的配置文件路径 SHOW VARIABLES LIKE 'config_file';
基础配置模板说明
以下是一个适配大多数单机场景的基础my.ini配置模板，包含核心的路径、端口、字符集等参数：
[mysqld] # MySQL安装根目录，根据实际解压或安装路径修改 basedir=D:/mysql-8.0.33/ # 数据文件存放目录，需要确保该路径存在且有写入权限 datadir=D:/mysql-8.0.33/data/ # 服务端口，默认3306，冲突时可修改 port=3306 # 服务端默认字符集，设置为utf8mb4支持所有中文和特殊字符 character-set-server=utf8mb4 # 默认存储引擎 default-storage-engine=INNODB # 允许最大连接数 max_connections=200 # 关闭符号链接，防止安全风险 symbolic-links=0 [mysql] # 客户端默认字符集 default-character-set=utf8mb4 [client] # 客户端连接端口，和mysqld的port保持一致 port=3306 default-character-set=utf8mb4
核心参数详解
路径相关参数
basedir指定MySQL的安装根目录，所有二进制文件和依赖库都从该路径下读取；datadir指定数据文件的存放位置，数据库的所有表数据、日志文件都会保存在这个目录下，修改该参数前需要确保目标路径已经创建，并且MySQL服务有读写权限。
性能相关参数
innodb_buffer_pool_size是InnoDB存储引擎的核心缓存参数，建议设置为物理内存的50%-70%，例如8G内存的服务器可以设置为4G：
[mysqld] # 设置InnoDB缓冲池大小为4G，根据服务器内存调整 innodb_buffer_pool_size=4G
max_connections设置允许的最大客户端连接数，默认151，如果应用并发量较高，可以适当调大，避免连接数不足导致报错。
字符集参数
需要将character-set-server、default-character-set都设置为utf8mb4，避免使用旧版utf8字符集无法存储表情符号等特殊字符的问题，同时保证服务端和客户端字符集统一，防止中文乱码。
配置修改生效步骤
修改my.ini文件后，需要重启MySQL服务才能让配置生效，具体步骤如下：
- 按下Win+R组合键，输入services.msc打开服务管理面板。
- 找到名称为MySQL或者MySQL80的服务，右键选择重启。
- 如果重启失败，可以打开Windows事件查看器，查看应用程序日志中的MySQL错误提示，排查配置参数是否有误。
也可以通过命令行重启服务，需要以管理员身份运行命令提示符：
# 停止MySQL服务，服务名根据实际安装名称调整 net stop MySQL80 # 启动MySQL服务 net start MySQL80
常见配置错误排查
- 路径使用反斜杠导致报错：Windows路径需要统一使用正斜杠/或者双反斜杠\，例如D:mysql需要写成D:/mysql或者D:\mysql，单反斜杠会被识别为转义字符导致路径读取失败。
- 参数名拼写错误：例如把
innodb_buffer_pool_size写成innodb_buffer_pool_szie，会导致MySQL启动时报未知变量错误，需要仔细核对参数名。 - 端口被占用：如果修改port后启动失败，可以使用
netstat -ano | findstr 3306命令查看端口是否被其他进程占用，更换未被占用的端口即可。