mysql 的 mysql 命令提示“command not found”的根本原因是系统未将 mysql 可执行文件所在目录（如 /usr/local/mysql/bin 或 c:\program files\mysql\mysql server 8.0\bin）加入 path 环境变量，导致 shell 或命令行无法定位该命令。
MySQL 的 mysql 命令为什么提示“command not found”
根本原因是系统找不到 mysql 可执行文件的路径。它通常安装在 /usr/local/mysql/bin/mysql（macOS/macOS Homebrew）、C:\Program Files\MySQL\MySQL Server 8.0\bin\mysql.exe（Windows）或 /usr/bin/mysql（某些 Linux 发行版预装），但该目录未加入 PATH 环境变量。
- Linux/macOS：检查是否真的安装了 MySQL 客户端（而不仅是服务端），运行
which mysqld只能确认服务进程存在，不代表有mysql命令行客户端 - Windows：MySQL Installer 默认不勾选「Add MySQL to PATH」，需手动确认或重装时勾选
- Homebrew 安装的 MySQL（macOS）：从 MySQL 8.0.33 起，
mysql不再软链到/usr/local/bin，必须手动配置
Linux/macOS 下添加 /usr/local/mysql/bin 到 PATH
先确认 MySQL 安装位置：
ls -l /usr/local/mysql/bin/mysql
若存在，将该路径追加到 shell 配置文件（如 ~/.zshrc 或 ~/.bash_profile）末尾：
echo 'export PATH="/usr/local/mysql/bin:$PATH"' >> ~/.zshrc source ~/.zshrc
- 用
source重新加载后，立即生效，无需重启终端 - 不要写成
export PATH="$PATH:/usr/local/mysql/bin"—— 某些旧版 macOS 的mysql依赖同目录下的libmysqlclient.dylib，放后面可能因动态库搜索顺序失败 - 如果使用 Homebrew 安装，路径可能是
/opt/homebrew/opt/mysql-client/bin（Apple Silicon）或/usr/local/opt/mysql-client/bin（Intel），用brew --prefix mysql-client查准
Windows 中设置 MySQL PATH 的两个关键点
图形化设置容易漏掉一步：必须同时设置「系统变量」或「当前用户变量」，且修改后要新开命令行窗口才生效。
- 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
- 在「系统变量」中找到
Path，点击「编辑」→「新建」→ 粘贴 MySQL 的bin目录完整路径（例如：C:\Program Files\MySQL\MySQL Server 8.0\bin） - ⚠️ 注意：路径中不能有中文、空格或括号（如
C:\Program Files (x86)\...），否则mysql --version可能报错The system cannot find the path specified.；此时建议用短路径名（C:\Progra~1\MySQL\...）或重装到无空格路径（如C:\mysql\）
验证是否生效及常见失败反馈
运行以下命令检查：
mysql --version which mysql # macOS/Linux where mysql # Windows
- 如果输出版本号（如
mysql Ver 8.0.33 for macos13.4 on arm64），说明成功 - 如果仍报错
command not found或'mysql' is not recognized，大概率是 shell 配置未重载（Linux/macOS）或没开新终端（Windows） - 如果报错
Can't connect to local MySQL server through socket，说明mysql命令已可用，只是服务没启动——这是另一个问题，和环境变量无关
PATH 配置本身很简单，但路径拼错、shell 未重载、Windows 空格路径这三处最容易卡住人。别急着重装 MySQL，先用 find 或资源管理器确认 mysql 文件真实位置，再对症加进 PATH。
