【MySQL排错 】mysql: command not found 数据库安装后无法加载的解决办法
【MySQL排错 】mysql: command not found 数据库安装后无法加载的解决办法
A Solution to Solve Error - mysql: command not found After The Installation of MySQL Community Server
By Jackson@ML
本文简要介绍如何在macOS安装完毕MySQL数据库服务器后，针对无法启动MySQL数据库服务器的故障解决办法。希望对读者有所帮助。
首先，我们盘点一下下载安装的全过程。
1. 获取MySQL
安装前，需要从MySQl官网下载并获取安装包: https://www.mysql.com/
在导航栏里，选择DOWNLOADS，进入下载页面。
选择页面下方的链接：MySQL Community (GPL) Downloads，进入应用软件选择页面：
点击MySQL Community Server进入版本选择页面。
根据本机macOS系统，选择第一行macOS 15(ARM, 64-bit), DMG Archive，点击Download开始下载。
MySQL Community Downloads下载前，询问是否注册，注册看需求决定；
- 如果有Oracle账户就直接登录；
- 如果不想注册和登录，点击下方No thanks, just start my download进行下载即可。
几分钟后下载完毕，在Downloads（下载）文件夹里，找到安装包文件mysql-9.2.0-macos15-arm64.dmg。
2. 安装MySQL
之前介绍过，通过安装包启动安装向导来安装MySQL Community Server，安装过程不再赘述，请参看文章：
2025最新版MySQL安装使用指南
3. 验证MySQL版本
刚才我们已经将MySQL安装向导完成并关闭，然后，打开Terminal（终端），执行命令验证MySQL版本：
$ mysql –version
结果，出现报错信息，如下图：
系统显示 -bash: mysql: command not found，即“命令未发现”。
明明在刚才下载和安装完成，为什么找不到MySQL呢？
初步判断，可能是环境变量没有加载，或者没有配置正确。
4. 配置环境变量
由于无法直接验证版本和访问MySQL, 因此需要先检查和设置MySQL的环境变量。
1） 获取安装路径
在macOS系统中，在搜索栏(Spotlight Search)，输入/usr，进入子文件夹，如下图：
双击打开local文件夹，如下图：
点击高亮显示的msql-9.2.0-macos15-arm64q文件夹并打开它。
再进入子文件夹bin，并右键单击状态栏的path路径，选择Copy “bin” as Pathname复制PATH变量路径。如下图所示。
接下来，打开Terminal，切换到用户目录，执行以下命令：
$ ls -la
发现列表中有个文件.bash_profile如下图：
执行以下命令打开该文件：
$ open .bash_profile
此时，已启动Text Edit编辑器，添加刚才复制的路径，新增两行如下语句：
PATH=${PATH}:/usr/local/mysql-9.2.0-macos15-arm64/bin
export PATH
然后，在TextEdit的File菜单中选择Save保存该文件，退出编辑器。
在Terminal中，打开该文件：
$ source .bash_profile
5. 启动MySQL开发服务器：
$ mysql -u root -p
如下图所示，已经打开MySQL Shell命令行：
执行以下命令，以查看现存数据库清单：
$ show databases;
很容易看到，列出了内置或已经建立的数据库，如下图所示：
这个列表表明，已经内置或者创建的数据库，共有八个。
至此，我们成功启动了MySQL Shell命令行。这说明问题解决，故障排除！
技术好文陆续推出，敬请持续关注和点赞。
您的认可，我的动力！😃
相关阅读：
- 2025最新版MySQL数据库安装使用指南
- MySQL入门 - 设置环境变量和使用系统数据库
- MySQL入门 - CRUD基本操作