mysqlsh是独立于mysql server的高级客户端工具，需单独下载安装，支持javascript、python和sql三种模式，默认使用x protocol（33060端口），连接逻辑与传统mysql客户端本质不同。
mysqlsh 不是随 MySQL Server 自动安装的独立工具，必须单独下载安装。它支持 JavaScript、Python 和 SQL 三种模式，但连接和配置逻辑与传统 mysql 客户端有本质区别——比如默认走 X Protocol（端口 33060），而非传统 SQL 协议（3306）。装错版本或忽略协议差异，会导致连不上、报错 Access denied for user 或 Unknown authentication plugin 'caching_sha2_password'。
怎么选安装包？看系统+glibc+架构三要素
别直接点“Download”就下。MySQL Shell 对系统环境敏感，尤其 Linux：
- 先查内核和 glibc 版本：uname -a 和 ldd --version
- CentOS 7 / RHEL 7 对应 glibc2.17，Ubuntu 20.04 是 glibc2.31，选错会提示 cannot execute binary file: Exec format error
- x86_64 和 aarch64（ARM）包不能混用，M1/M2 Mac 必须选 arm64 版本
- Windows 用户注意：必须提前装好 Visual C++ Redistributable for Visual Studio 2017，否则双击 .msi 直接失败
Linux 手动解压安装后，PATH 和软链接不能省
二进制包（.tar.gz）解压后只是个目录，不配置就只能写绝对路径调用：
- 解压后建议建软链接：ln -s mysql-shell-8.0.36-linux-glibc2.17-x86-64bit /usr/local/mysql-shell
- 把 /usr/local/mysql-shell/bin 加进 /etc/profile 或 ~/.bashrc，否则新终端里 mysqlsh 命令找不到
- 验证：which mysqlsh 应返回路径；mysqlsh --version 显示版本号才算真生效
连接时用 --uri 还是 -h/-u/-p？协议决定语法
mysqlsh 默认启用 X Protocol，传统 -h -u -p 参数只走 classic session（SQL 模式），而 --uri 可显式指定协议：
- 连经典模式（兼容老客户端）：mysqlsh -h 127.0.0.1 -P 3306 -u root -p
- 连 X Protocol（推荐，支持文档存储和 CRUD API）：mysqlsh --uri root@127.0.0.1:33060（注意端口是 33060）
- URI 中密码可编码（避免 shell 历史泄露）：mysqlsh --uri root:password%40123@127.0.0.1:33060（@ 要 URL 编码为 %40）
- 如果连不上，先确认 MySQL Server 是否启用了 X Plugin：SELECT PLUGIN_NAME, PLUGIN_STATUS FROM INFORMATION_SCHEMA.PLUGINS WHERE PLUGIN_NAME = 'mysqlx';，状态必须是 ACTIVE
首次启动报 caching_sha2_password 错误？不是密码错，是认证插件不匹配
MySQL 8.0 默认用 caching_sha2_password，但旧版 mysqlsh（如 8.0.23 之前）不支持，会卡在登录界面或报错：Authentication plugin 'caching_sha2_password' cannot be loaded
- 最简方案：升级 mysqlsh 到 8.0.30+（2025 年后发布的版本基本都支持）
- 临时绕过（不推荐生产）：重置用户认证方式：ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'yourpass';
- 更稳妥做法：创建专用用户并指定插件：CREATE USER 'shelluser'@'%' IDENTIFIED WITH caching_sha2_password BY 'strongpass'; GRANT ALL ON *.* TO 'shelluser'@'%';，再用该用户连
真正容易被忽略的是 X Plugin 的启用状态和 URI 中端口的隐式切换——很多人照着 mysql 客户端习惯写 -P 3306，却没意识到 mysqlsh 默认连的是 33060，结果连上一个空会话还纳闷“为什么 \use db 不生效”。
