很多开发者在搭建本地开发环境或服务器时,都会选择 MySQL 8.0.20 这个稳定版本。相比旧版,它在性能和安全上都有明显提升,但初次接触的新手往往会在初始化和服务注册环节卡住。下面这份教程完全基于实际踩坑经验整理,步骤清晰,照着做就能顺利跑起来。
准备工作与文件下载
首先确保你的电脑是 Windows 系统,并且已经关闭了杀毒软件对核心目录的拦截。去官网或者镜像站下载 MySQL 8.0.20 的 ZIP Archive 压缩包。注意不要下载 MSI 安装包,ZIP 版更干净,不会乱写注册表,方便后续管理。下载完成后,把压缩包解压到一个没有中文、没有空格的路径下,比如 D盘下的 mysql-8.0.20 文件夹。记住这个路径,后面配置全靠它。
创建配置文件
进入解压后的根目录,新建一个文本文档,重命名为 my.ini。用记事本打开它,写入基础配置。这部分直接决定数据库能不能正常启动。内容如下:[mysqld] basedir=D:\\mysql-8.0.20 datadir=D:\\mysql-8.0.20\\data port=3306 character-set-server=utf8mb4 default-storage-engine=INNODB sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION [client] default-character-set=utf8mb4 注意路径里的双反斜杠必须保留,否则系统读取会报错。保存后关闭文件,这一步千万别跳过。
初始化与注册服务
接下来用管理员身份运行命令提示符。按 Win 键输入 cmd,右键以管理员身份运行。先进入 MySQL 的 bin 目录,输入 cd /d D:mysql-8.0.20bin。然后执行初始化命令:mysqld --initialize-insecure --console。加上 insecure 参数的好处是不用手动找临时密码,初始化后可以直接设新密码。执行过程中终端会滚动一堆日志,等提示符回来,说明初始化成功,此时根目录下会自动多出一个 data 文件夹,里面全是数据库底层文件。
初始化完成后,继续在同一窗口输入 mysqld --install MySQL80 --defaults-file=D:mysql-8.0.20my.ini。这步是把 MySQL 注册到 Windows 服务管理器里,服务名设为 MySQL80。看到 Service successfully installed 就说明注册完毕。接着输入 net start MySQL80 启动服务,提示服务已启动即可。
修改密码与远程访问配置
服务跑起来后,命令行输入 mysql -u root -p 登录。因为刚才初始化没设密码,直接回车就能进去。进去之后先别急着干活,第一件事就是改密码。执行 ALTER USER 'root'@'localhost' IDENTIFIED BY '你的新密码'; 把密码改掉。刷新权限 flush privileges; 退出 exit。
如果你需要让局域网其他电脑也能连这台数据库,得开放权限。再次登录数据库,执行 CREATE USER '用户名'@'%' IDENTIFIED BY '密码'; 再执行 GRANT ALL PRIVILEGES ON *.* TO '用户名'@'%'; 最后 flush privileges; 这样任何 IP 都能用这个账号连接。记得检查 Windows 防火墙是否放行了 3306 端口,不然外面连不进来。
常见问题排查
启动失败是最常见的情况。如果提示找不到 dll 文件,通常是电脑缺 VC++ 运行库,去微软官网下载安装最新的 Visual C++ Redistributable 就行。如果报 1067 错误,大概率是 my.ini 路径写错或者 data 文件夹被占用,删掉 data 重新初始化一次。另外,MySQL 8.0 默认认证插件是 caching_sha2_password,部分老版本的 Navicat 连不上,需要在数据库里执行 ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '密码'; 切换回老插件,兼容性立刻恢复。
为了方便在任意命令行直接调用 mysql 命令,建议把 bin 目录加到系统环境变量 PATH 里。右键此电脑选属性,高级系统设置,环境变量,找到 Path 编辑,新建一行填入你的 bin 绝对路径。确认保存后,重启命令行窗口,直接敲 mysql -V 能看到版本号就算配置成功。测试连接时用 Navicat 或者 DBeaver 新建连接,主机填 localhost,端口 3306,输入刚设置的密码,点击测试连接显示成功即可。至此整个环境彻底搭建完成,可以放心进行建库建表操作。



