很多开发者在搭建本地开发环境时,依然会用到 MySQL 5.5 这个经典版本。相比于安装包版,解压版更加轻量且路径完全可控,非常适合需要灵活配置或批量部署的场景。下面将手把手带你完成从解压到成功运行的全过程,避开常见坑点,确保一次装好。
第一步:下载与解压配置
首先从官方归档或可靠镜像站获取 MySQL 5.5 的 Windows 通用压缩包。强烈建议将其解压到一个全英文、无空格、无特殊符号的路径下,例如 D:\mysql-5.5.62-winx64。路径越短越好,后续配置命令不容易出错。解压完成后,你会看到多个文件夹,其中 data 文件夹如果是空的,说明还没初始化,这是正常现象,千万不要手动往里面塞东西。
第二步:设置系统环境变量
为了让任意位置都能直接调用 mysql 命令,需要添加环境变量。右键点击桌面此电脑选择属性,进入高级系统设置,打开环境变量。在系统变量里找到 Path,点击编辑,新建一条记录,填入你的解压根目录下的 bin 文件夹地址,比如 D:\mysql-5.5.62-winx64\bin。保存后,务必重新打开一个全新的命令行窗口,输入 mysql --version 验证是否显示版本号,出现即代表配置成功。
第三步:编写 my.ini 配置文件
解压版默认没有 ini 文件,需要手动创建。在解压根目录下新建一个文本文件,重命名为 my.ini。用记事本打开,粘贴以下核心配置内容:
[client]
default-character-set=utf8
[mysqld]
port = 3306
basedir=D:\\mysql-5.5.62-winx64
datadir=D:\\mysql-5.5.62-winx64\\data
character-set-server=utf8
collation-server=utf8_general_ci
注意 basedir 和 datadir 的双反斜杠是必要的转义写法,千万别漏掉。保存后关闭文件。这里设置了默认端口为 3306,字符集统一为 utf8,能彻底避免后期导入数据时出现中文乱码问题。
第四步:以管理员身份初始化并注册服务
这一步最关键,必须使用管理员权限运行命令提示符。按 Win+R 输入 cmd,在搜索结果右键选择以管理员身份运行。依次执行两条命令。第一条是初始化数据目录:mysqld --initialize-insecure。执行过程中屏幕会滚动日志,等待光标回到下一行即表示生成完毕,此时根目录下会自动多出 data 文件夹及一系列 ibd 文件。第二条是安装 Windows 服务:mysqld --install MySQL。如果提示 Service successfully installed,说明服务已注册成功。
第五步:启动服务与重置 Root 密码
服务安装好后,继续在同个管理员窗口输入 net start mysql 启动数据库。看到服务名下方提示服务已成功启动,就大功告成了。由于前面用的是 insecure 初始化方式,初始 root 密码为空。直接输入 mysql -u root -p,遇到密码提示直接回车即可登录。进入 mysql 命令行后,执行以下语句将密码改为自定义内容:
SET PASSWORD FOR 'root'@'localhost' = PASSWORD('123456');
输入 quit 退出客户端。现在你可以用新密码重新登录了。如果遇到登录被拒绝,通常是 data 目录权限不足,右键 data 文件夹勾选完全控制权限即可解决。
常见问题排查建议
安装过程中如果卡住,优先检查防火墙是否拦截了 3306 端口,或者确认 my.ini 里的路径拼写是否正确。另外,MySQL 5.5 属于较老版本,现代操作系统运行偶尔会有兼容提示,一般不影响核心功能。完成以上步骤,你的本地开发环境就已经就绪,可以直接导入测试数据进行后续开发了。记住每次修改完配置文件都要重启 mysql 服务才能生效。