推荐mycli 听说pgcli 是最接近 mycli 体验的，如果你偶尔也要用 PostgreSQL，可以试试看。
本文主要是 mycli

---

MySQL 自动补全与语法高亮神器：mycli 安装与使用完全指南 (2026 更新版)

💡 文章前言：如果你还在使用传统命令 mysql -u root -p 操作数据库，面对枯燥的黑底白字和频繁的输错命令，那么 mycli 绝对是你的“效率救星”。它支持智能 SQL 自动补全、语法高亮、多行编辑等现代化交互能力，适合运维、DBA 和研发人员使用。

1. mycli 简介

mycli 是一个基于 Python 开发的、开源的 MySQL 命令行客户端，可作为 mysql 命令的现代替代品。它不仅完美支持 MySQL，同样适用于 MariaDB 和 Percona。

核心特性：

• 智能自动补全：输入 SELECT * FROM 时自动提示表名，输入 WHERE 时自动提示列名。
• 语法高亮：通过 Pygments 库使 SQL 关键字、函数、字符串颜色区分，易读性大大提升。
• 多行查询与历史记录：无需像原生 mysql 那样单行输入，mycli 完美支持多行编辑，且按 Ctrl+R 可搜索历史命令。
• 配置文件与主题：支持修改提示符、更换颜色主题、保存常用查询别名等。
• SSL 与 SSH 隧道：支持通过 SSL 加密连接，满足生产环境的安全需求。

2. 安装与兼容性说明（2026 年最新）

根据 2026 年 mycli 在 PyPI 和 GitHub 上的发布情况，最新版本已经演进到 v1.67.1，其中包含大量针对 Python 3.12 及以上版本的优化和依赖升级。

⚠️ 特别注意（Python 3.6 用户必看）：

• 如果当前系统 Python 版本为 3.6，mycli 的 1.24.0 版本是被验证最稳定的选择，更高版本（≥1.25.0）通常需要 Python 3.7 以上环境。
• 测试证明：在 Python 3.6 环境下，mycli==1.24.0 配合 sqlglot==11.0.0 可以完美运行，解决 annotations 语法报错。

2.1 配置 pip 使用清华源（加速安装）

# 配置 pip 永久使用清华镜像源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

# 验证配置是否生效
pip config get global.index-url
# 应返回：https://pypi.tuna.tsinghua.edu.cn/simple

2.2 Python 3.6 环境一键安装（已测试可用）

# 1. 卸载冲突包
pip uninstall mycli sqlglot -y

# 2. 安装兼容的 sqlglot 版本
pip install sqlglot==11.0.0

# 3. 安装 mycli 1.24.0 版本
pip install mycli==1.24.0

# 4. 测试连接
mycli -uroot -p123456

2.3 Python 3.8+ 或更高版本（推荐）

对于 Python 3.8 及以上版本的环境，建议直接安装最新版本以获得更多功能：

# 安装最新版本（包含所有可选依赖）
pip install -U mycli

# 或者使用 uv 工具安装（更快速、更现代）
uv tool install mycli

2.4 使用系统包管理器安装（备选方案）

如果不想处理 Python 环境依赖，也可以使用系统包管理器：

系统版本	安装命令	注意事项
Debian/Ubuntu	sudo apt update && sudo apt install mycli	仓库版本可能滞后于 PyPI，通常为 1.24.x 系列
Fedora (22+)	sudo dnf install mycli	仓库版本更新相对及时
RHEL/CentOS 7/8	sudo yum install epel-release && sudo yum install python-pip && pip install mycli	需要先启用 EPEL 源
macOS	brew update && brew install mycli	macOS 推荐使用 Homebrew 安装

3. 配置与个性化（2026 年新特性）

mycli 在首次启动时会自动生成配置文件 ~/.myclirc，你可以通过修改它来定制体验。

3.1 修改语法高亮主题

mycli 官方提供了多套颜色主题，在 ~/.myclirc 中找到 syntax_style 参数进行修改：

# ~/.myclirc 文件片段
syntax_style = monokai   # 可选值：default, manni, perldoc, borland, vim, monokai 等

官方颜色主题库可访问：https://www.mycli.net/syntax

3.2 修改命令提示符

如果不喜欢默认的 (none)> 提示符，可以修改 prompt 参数：

prompt = '\u@\h [\d]> '  # 示例格式：root@localhost [test_db]>

3.3 启用查询日志记录

mycli 可以记录每个查询及其结果，便于审计和回顾（默认禁用）：

# ~/.myclirc
log_file = ~/.mycli.log  # 指定日志文件路径

4. 基本使用与连接方式

4.1 连接数据库

mycli 完全兼容 mysql 命令的连接参数，没有任何学习成本：

# 方式一：使用参数指定主机和用户（推荐）
mycli -h 127.0.0.1 -P 3306 -u root -p

# 方式二：连接并直接指定数据库
mycli -u root -p123456 my_database

# 方式三：使用 DSN (Data Source Name) 连接
mycli mysql://root@localhost:3306/my_database

4.2 常用快捷键

mycli 内置了丰富的快捷键，源自 prompt_toolkit 库，大幅提升操作效率：

快捷键	功能描述
Ctrl + R	反向搜索历史命令
Ctrl + W	删除光标前的一个单词
Ctrl + U	删除光标前的所有字符
Ctrl + K	删除光标后的所有字符
Tab	智能补全（关键字、表名、列名）
Ctrl + C	取消当前输入（不会退出客户端，与原生 mysql 不同）
Ctrl + D	退出 mycli
F2	切换多行编辑模式

4.3 常用内建命令

在 mycli 会话中，可以使用反斜杠开头的内建命令：

命令	功能
\? 或 \h	显示帮助信息
\l	列出所有数据库
\d [table_name]	查看表结构
\dt	列出当前数据库的所有表
\fs [alias] [query]	将常用查询保存为别名
\f [alias]	执行保存的别名查询
\e	在外部编辑器中编辑当前查询
\q	退出客户端

4.4 多行查询示例

与原生 mysql 不同，mycli 天生支持多行查询，输入更加自由：

mycli> SELECT 
    ->   user_id,
    ->   user_name,
    ->   created_at
    -> FROM users
    -> WHERE status = 'active'
    -> ORDER BY created_at DESC
    -> LIMIT 10;

5. 常见问题与故障排除（2026 年新版）

5.1 自动补全失效或卡顿

现象：输入 SQL 时没有弹出补全建议，或补全速度极慢。

原因与解决：

1. 大型数据库：如果数据库包含上千张表，mycli 在启动时加载元数据会消耗大量内存和时间。建议对不常用的数据库使用 mycli --less-chatty 模式。
2. 连接问题：确保数据库连接稳定，补全功能依赖获取数据库元数据。
3. 配置文件干扰：检查 ~/.myclirc 中是否误禁用了补全功能。

5.2 字符集乱码或表格边框异常

现象：查询结果的表格边框或中文显示为乱码。

解决：

• 检查终端字符编码设置为 UTF-8。
• 确保终端字体支持特殊字符（推荐使用等宽字体，如 Fira Code、Consolas）。

5.3 from __future__ import annotations 语法错误（Python 3.6 专属）

现象：运行 mycli 时报 SyntaxError: future feature annotations is not defined。

解决：

pip install sqlglot==11.0.0

原因：新版 sqlglot 依赖需要 Python 3.7+ 才支持的 annotations 特性，降级到 11.0.0 版本即可兼容 Python 3.6。

5.4 mycli: command not found 命令找不到

现象：安装成功后输入 mycli 提示命令未找到。

解决：

• 方案一：关闭当前终端窗口后重新打开（环境变量刷新问题）。
• 方案二：使用完整路径执行：python -m mycli.main -u root -p
• 方案三：确认 Python 脚本目录（通常是 ~/.local/bin/ 或 Python 安装目录下的 bin/）已加入 PATH 环境变量。

5.5 连接时提示 Access denied

现象：Access denied for user 'root'@'localhost'。

解决：

1. 确认 MySQL 用户密码正确。
2. 检查用户是否有从当前主机连接的权限。
3. 尝试使用 mysql -u root -p 确认密码正确性后再用 mycli 重试。

6. 实用替代方案推荐

如果 mycli 在特定环境下无法满足需求，以下是几种优秀的替代方案：

工具名称	类型	适用场景
原生 mysql	命令行	轻量级、稳定、兼容性最好，适合脚本化场景
pgcli	命令行	PostgreSQL 用户的首选，由同一团队开发
litecli	命令行	SQLite 数据库的增强客户端
usql	命令行	通用 SQL 客户端，支持多达 20+ 种数据库（PostgreSQL、MySQL、Oracle、SQLite 等）
DBeaver	GUI	功能最强大的跨平台数据库管理工具，适合复杂查询和数据库设计
HeidiSQL	GUI	Windows 平台下轻量好用的 MySQL 管理工具，开源免费

7. 总结

mycli 作为原生 mysql 命令的现代化替代方案，通过智能补全和语法高亮等功能显著提升了命令行下数据库操作的效率与体验。本文提供的安装方案已在 Python 3.6 环境（使用 mycli==1.24.0 + sqlglot==11.0.0）和 Python 3.10+ 环境（使用最新版 mycli）中验证通过，适用于 2026 年的主流 Linux 发行版。

快速选择指南：

• 如果你的 Python 版本 ≥ 3.10，直接 pip install mycli 即可享受最新特性。
• 如果你的 Python 版本 = 3.6，使用本文提供的兼容命令，mycli 依然可以完美工作。
• 如果你只想快速体验不想折腾 Python 环境，使用系统包管理器安装是最省心的选择。

希望这份更新的指南能帮助你在 2026 年及以后更高效地管理你的数据库。如有其他问题，欢迎随时交流！