必须将mysql的bin目录添加到path环境变量才能直接使用mysql命令;否则执行mysql -u root -p会提示命令未找到;windows需在系统环境变量path中添加mysql.exe所在完整路径,macos/linux需在shell配置文件中追加export path="实际bin路径:$path"并source生效。

MySQL 的 bin 目录必须加到 PATH 才能直接用 mysql 命令
不配置环境变量,你在任意目录下执行 mysql -u root -p 会报错:command not found: mysql(macOS/Linux)或 'mysql' is not recognized as an internal or external command(Windows)。本质是系统找不到 mysql 这个可执行文件——它藏在 MySQL 安装目录的 bin/ 子目录里。
Windows 上怎么加 PATH:找到 mysql.exe 所在目录再添加
默认安装路径因版本和选项而异,常见位置包括:
C:\Program Files\MySQL\MySQL Server 8.0\binC:\Program Files (x86)\MySQL\MySQL Server 5.7\bin- 如果你用 MySQL Installer 自定义安装过,可能在
C:\mysql\bin或你指定的路径
确认方法:打开文件资源管理器,进入安装目录,看是否存在 mysql.exe;或者用 Everything 搜索 mysql.exe。
添加步骤(图形界面):
- 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
- 在「系统变量」中双击
Path→ 「新建」→ 粘贴上面找到的完整bin路径 - 点「确定」保存,**重启所有已打开的命令行窗口**(CMD/PowerShell/Terminal)
macOS/Linux 怎么加 PATH:改 shell 配置文件,注意区分 zsh/bash
macOS Catalina 及以后默认用 zsh,老系统或自定义用户可能是 bash。先确认当前 shell:
echo $SHELL
然后编辑对应配置文件:
基于ThinkPhp6+ swoole4+uniapp 开发的一套CRMEB新零售多商户商城系统。如果不会搭建请到 查看搭建说明系统环境推荐 使用 宝塔配置环境centos PHP7.3 mysql5.6新增功能: 01·新增支持销售虚拟产品自动发货 02.支持销售链接与卡密可导入导出 03.自定义后台路径对后台进行保护 04.新增支持商家缴纳保证金功能 05·违法或侵权商品一键举报功能 06·仲
- zsh → 编辑
~/.zshrc - bash → 编辑
~/.bash_profile或~/.bashrc
在文件末尾追加一行(把 /usr/local/mysql/bin 替换成你实际的 bin 路径):
export PATH="/usr/local/mysql/bin:$PATH"
保存后运行:
source ~/.zshrc # 或 source ~/.bash_profile
验证是否生效:
which mysql
应输出你刚添加的路径。
常见坑:路径写错、没重启终端、权限问题、多个 MySQL 冲突
容易出问题的地方:
-
PATH中路径末尾**不要加斜杠**(/usr/local/mysql/bin/❌,应为/usr/local/mysql/bin✅) - 改完配置后,旧终端不会自动重载,必须新开一个或执行
source - macOS 上如果用 Homebrew 安装了 MySQL(
brew install mysql),它的bin在/opt/homebrew/bin(Apple Silicon)或/usr/local/bin(Intel),且通常已自动加入PATH,不用手动加 - 同时装了多个 MySQL(比如 XAMPP + 官方版),
PATH顺序决定调用哪个,用which mysql和mysql --version确认实际生效的是哪一个 - Linux 上某些发行版(如 Ubuntu)用
apt install mysql-client安装的客户端,二进制在/usr/bin/mysql,也不需要额外配PATH
最稳妥的做法:先确认你要用的是哪个 MySQL 实例,再精准定位它的 bin 目录,只加这一个路径,避免混淆。









