Mac OS X 安装 MySQL 完整指南:从下载到配置启动

Owen
Owen
发布时间:2026-10-14| 2人浏览过
原创

本文详细介绍在 macOS 系统上通过 DMG 安装包部署 MySQL 数据库的完整流程。内容涵盖官方版本选择、PKG 包顺序安装、符号链接机制解析,以及利用 StartupItem 或手动命令启动服务的具体操作。同时包含常见的 socket 连接错误排查方法,帮助用户快速搭建本地开发环境。

一、下载与安装准备

首先访问 MySQL 官网下载中心,选择对应 Mac OS X 的版本。推荐使用 DMG 格式的归档文件进行安装,因其提供可视化的安装向导,比压缩包方式更为便捷。

二、执行安装步骤

下载完成后,双击打开 .dmg 镜像文件,按照以下顺序执行安装操作:

第1步:安装主程序包

目的:安装 MySQL 核心二进制文件及客户端工具。

操作:在挂载的磁盘映像中找到名为 mysql-VERSION-osx...pkg(例如 mysql-5.6.12-osx10.7-x86_64.pkg)的安装包,双击运行并跟随提示完成安装。

第2步:配置开机自启服务

目的:允许系统在启动时自动加载 MySQL 服务,无需每次手动输入命令。

操作:在同一磁盘中找到 MySQLStartupItem.pkg 并进行安装。

第3步:验证安装布局

结果:安装程序会将所有二进制代码置于 /usr/local/mysql/bin/ 目录下,并创建默认套接字文件 /tmp/mysql.sock。同时,系统会在 /usr/local 下创建一个名为 mysql 的符号链接(Symbolic Link),指向实际安装的版本号目录。如果此前存在旧的 /usr/local/mysql 目录,安装前建议将其重命名为 /usr/local/mysql.bak 以避免冲突。

三、启动 MySQL 服务

安装完成后,需通过终端启动 MySQL 守护进程。根据是否已配置自启项,有两种方式:

方式A:使用 StartupItem 启动

适用场景:已完成第2步安装的用户。

操作入口:终端(Terminal)。

具体动作:以管理员权限执行以下命令:

sudo /Library/StartupItems/MySQLCOM/MySQLCOM start

注意:若需禁用开机自启,可编辑 /etc/hostconfig 文件,将 MySQLCOM=-YES- 修改为 MySQLCOM=-NO-。

方式B:手动前台启动

适用场景:未安装 StartupItem 或需要临时调试的服务。

具体动作:依次执行以下命令序列:

cd /usr/local/mysql
sudo ./bin/mysqld_safe

完成状态:命令执行后若进入后台挂起状态,可输入 bg 让其在后台继续运行,随后按 Ctrl+D 退出 Shell 或输入 exit。

四、测试连接与排错

第1步:尝试登录

操作:在终端中输入以下命令启动 MySQL 客户端:

/usr/local/mysql/bin/mysql

第2步:处理 Socket 连接错误

问题现象:若出现 Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2) 错误。

原因分析:客户端尝试连接的默认 Socket 路径与实际服务监听路径不一致。

解决方法:

  1. 进入 MySQL 配置目录:cd /usr/local/mysql/bin/(注:部分版本配置文件位于 /etc/my.cnf 或 /usr/local/mysql/support-files/my-default.cnf)。
  2. 使用文本编辑器打开对应的 my.cnf 文件。
  3. 在 [mysqld] 和 [client] 段落下明确添加或确认参数:socket = /tmp/mysql.sock。
  4. 保存后重启 MySQL 服务使配置生效。

五、简要总结

通过以上步骤,您可以在 Mac 上成功部署并运行 MySQL 数据库。关键在于理解 PKG 安装后的目录结构,以及正确配置套接字路径以解决客户端连接问题。以上就是 Mac 安装 MySQL 的详细过程,更多关于 Mac 开发环境搭建的资料请关注本站其它相关文章!

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。