准备工作与下载路径
MySQL的DMG安装包是macOS用户最常用的一键部署方式,整个流程虽然直观,但里面有几个容易踩坑的细节。下面把从下载到完成配置的完整步骤拆解开,照着做就能顺利跑起来。
按顺序运行安装程序
首先需要访问MySQL官网的下载页面,选择Community Server版本。注意区分自己的Mac芯片类型,如果是苹果自研的M系列芯片,务必下载arm64架构的安装包;如果是Intel芯片,则选择x86_64版本。选错架构会导致后续无法启动或报错。点击Download后可能会跳转到登录注册界面,直接点击页面上的No thanks, just start my download即可跳过,开始下载dmg文件。
下载完成后双击打开DMG镜像文件,你会看到四个独立的pkg安装文件。千万不要只点第一个就一路回车,必须严格按照从上到下的顺序依次双击安装。这四个文件分别是MySQL主程序、数据库偏好设置面板、命令行工具以及图形化管理客户端。安装过程中系统会多次弹出输入本机管理员密码的提示框,这是macOS的安全机制,正常输入开机密码并点击确定即可。如果中途遇到权限拒绝的弹窗,检查是否开启了系统设置里的隐私与安全选项,允许来自已识别开发者的应用运行。
配置环境变量与启动服务
全部安装完毕后,进入终端环境进行变量配置。打开访达,前往应用程序文件夹,找到MySQL图标,点击右侧的小齿轮选择打开,或者直接在终端输入mysql命令测试。此时系统通常会提示command not found,这是因为默认安装路径没有加入全局环境变量。打开终端,编辑bash或zsh配置文件,在文件末尾追加export PATH=/usr/local/mysql/bin:$PATH这一行代码。保存退出后执行source命令使配置立即生效。对于新系统默认使用zsh的用户,记得修改的是.zshrc文件而不是.bash_profile。
接下来处理初始密码和后台服务启动。macOS的DMG安装版默认不会自动开机启动,需要手动开启守护进程。在终端输入sudo launchctl load /Library/LaunchDaemons/com.oracle.oss.mysql.mysqld.plist命令来注册服务。之后再次尝试连接数据库,系统会要求你输入刚安装时随机生成的一串临时密码,这串密码在安装最后一步的终端窗口里滚动显示过,通常以A temporary password is generated为开头。登录后必须立刻执行alter user命令修改密码,否则任何查询操作都会被拦截。
常见问题排查建议
如果遇到安装卡死或端口冲突的情况,先确认3306端口是否被其他软件占用。可以通过netstat命令查看当前监听状态。若是新电脑首次安装,建议在系统设置中关闭SIP保护模式再重试,部分安全策略会拦截MySQL的系统级写入。日常维护时,推荐搭配官方提供的图形化客户端使用,能直观管理用户权限和数据表。掌握这些基础步骤后,本地开发环境的数据库部署就完成了,后续按需调整配置文件中的字符集和缓存参数即可满足常规开发需求。



