用 brew 或 apt 安装 MySQL 后为什么 mysql
命令仍报 “command not found”
常见原因是安装后未将 MySQL 的 bin 目录加入
$PATH。macOS 用
brew install mysql默认装在
/opt/homebrew/opt/mysql/bin/（Apple Silicon）或
/usr/local/opt/mysql/bin/（Intel），Ubuntu/Debian 则通常通过
apt install mysql-client mysql-server安装，但客户端二进制可能在
/usr/bin/mysql，服务端在
/usr/sbin/mysqld。
验证是否已安装可执行文件：
ls -l /usr/bin/mysql /usr/local/bin/mysql /opt/homebrew/opt/mysql/bin/mysql 2>/dev/null
若存在但不可用，临时补路径：
export PATH="/opt/homebrew/opt/mysql/bin:$PATH"
永久生效需写入 shell 配置（如
~/.zshrc或
~/.bashrc）。注意：某些 Linux 发行版（如 Ubuntu 22.04+）默认安装的是
mysql-shell或
mariadb-client，运行
mysql --version返回 “
mysql Ver 15.1 Distrib 10.6.16-MariaDB” 就说明你实际连的是 MariaDB，不是 Oracle MySQL —— 大部分基础命令兼容，但高级特性（如角色管理、企业加密函数）不一致。
启动服务失败时检查 mysqld
是否真在运行，而非只靠 systemctl status mysql
systemctl status mysql显示 “active (running)” 并不能保证 MySQL 实例已监听连接。常见假阳性：服务进程存在，但初始化失败、端口被占、数据目录权限错误，导致
mysql -u root -p连不上。
排查步骤：
查真实监听状态：sudo lsof -i :3306 | grep LISTEN若无输出，说明 mysqld 没真正 bind 成功 看错误日志位置（Ubuntu 默认在
/var/log/mysql/error.log，macOS brew 在
/opt/homebrew/var/mysql/*.err），直接 tail 最新行：
sudo tail -n 20 /var/log/mysql/error.log常见报错 “
Can't start server: Bind on TCP/IP port: Address already in use” 表示 3306 被占用，可用
sudo ss -tulpn | grep :3306找出冲突进程 若提示 “
Failed to find valid data directory”，检查
datadir配置（
/etc/mysql/my.cnf或
/opt/homebrew/etc/my.cnf）对应路径是否存在且属主为
mysql用户
mysql -u root -p
登录失败：空密码、插件认证、socket 路径不对
MySQL 8.0+ 默认用
caching_sha2_password插件，而旧客户端或某些 GUI 工具不支持，报错 “
Plugin caching_sha2_password could not be loaded”。同时，macOS brew 安装后 root 默认无密码，但首次登录必须用 socket 方式（非 TCP），否则报 “
Access denied for user 'root'@'localhost'”。
安全跳过密码登录（仅限本地调试）：
sudo /opt/homebrew/opt/mysql/bin/mysqld_safe --skip-grant-tables &
然后新开终端执行：
mysql -u root
进去后重置密码并改认证插件（MySQL 8.0+）：
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_new_password';
更稳妥的做法是初始化时就指定 socket 路径登录：
mysql -u root -S /opt/homebrew/var/mysql/mysql.sock
Linux 上常见 socket 路径是
/var/run/mysqld/mysqld.sock，可通过
mysql --help | grep "Default options"查找配置文件读取顺序，再确认
socket项值。
建库、授权、导入 SQL 文件的最小可靠操作链
别一上来就
CREATE DATABASE myapp;，先确认字符集和排序规则，否则中文存入乱码：
CREATE DATABASE myapp CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;
新建用户并授权（避免用 root 连应用）：
CREATE USER 'myapp_user'@'localhost' IDENTIFIED BY 'strong_password';<br>GRANT SELECT, INSERT, UPDATE, DELETE ON myapp.* TO 'myapp_user'@'localhost';<br>FLUSH PRIVILEGES;
导入已有 SQL 文件（确保文件内不含
CREATE DATABASE，否则会报错）：
mysql -u myapp_user -p myapp < /path/to/data.sql
注意：如果 SQL 文件里有
USE database_name;，而目标库名与命令行指定的不一致，会导入到错误库；若含
DROP TABLE且表不存在，加
--force参数忽略错误：
mysql -u myapp_user -p --force myapp < data.sql
最后别忘了关掉跳过权限验证的服务（如果之前启了
--skip-grant-tables），否则数据库完全裸奔。
