【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命令行。这说明问题解决，故障排除！

技术好文陆续推出，敬请持续关注和点赞。
您的认可，我的动力！😃

相关阅读：

1. 2025最新版MySQL数据库安装使用指南
2. MySQL入门 - 设置环境变量和使用系统数据库
3. MySQL入门 - CRUD基本操作