data-atom是当前Atom连接数据库唯一可靠方案；它持续维护、支持MySQL/PostgreSQL/SQLite，具备连接保存、表结构浏览、右键执行等完整功能，安装命令为apm install data-atom，需重启Atom启用。
data-atom 是当前最可靠的选择
Atom 本身不连库，所有数据库操作都靠插件；data-atom 是目前唯一仍在维护、支持 MySQL / PostgreSQL / SQLite 且功能完整的插件。它不是“可选之一”，而是事实上的标准方案——其他如 database（hansonw 版）已多年未更新，atom-sql-runner 功能单薄、不支持连接管理与表结构浏览。
安装必须用命令行：apm install data-atom。在 Settings → Install 里搜“database”或“sql runner”容易误装旧版或弃用插件，直接失败。
- 安装后需重启 Atom，否则左侧栏不显示数据库图标
- 插件图标默认在左下角，不是左侧边栏顶部——第一次找不见时，试试把 Atom 窗口拉宽一点再扫一眼底部区域
- 如果安装后无反应，运行
apm list --installed确认data-atom在列表中；若不在，说明网络问题导致安装中断，重试命令并加--verbose
MySQL 连接配置里最容易填错的三项
按 Ctrl+Alt+D 调出面板，点 + 添加连接，填完测试失败？90% 出在这三处：
-
Host：本地 MySQL 别写127.0.0.1或空，统一填localhost（127.0.0.1在某些 MySQL 配置下会走 TCP，而localhost走 socket，权限可能不同） -
Port：不要依赖自动填充。确认你的 MySQL 实际端口：mysql -V查版本后，查my.cnf或运行netstat -tuln | grep :3306；MySQL 8.0 默认仍是 3306，但 Docker 启动时可能映射到其他端口 -
Password：如果密码含特殊字符（如@、/、:），data-atom会解析失败。临时改密码为纯字母数字再测试，连通后再换回
测试失败时，勾选插件设置里的 Debug Mode，然后看开发者工具 Console 输出的真实错误——常见的是 Access denied for user 'root'@'127.0.0.1'，说明账号没开远程权限，不是插件问题。
执行 SQL 时右键没反应？检查文件类型和语法绑定
data-atom 要求 .sql 文件被正确识别为 SQL 语法，否则右键菜单不出现 Execute Query。现象是：文件明明是 query.sql，右键只有“Copy Path”，没有执行项。
- 看编辑器右下角状态栏：必须显示
SQL，不能是Plain text或空白。如果不是，点击该区域 → 选择SQL - 如果点了还是变不回来，说明
language-sql插件没装或冲突。运行apm install language-sql，装完重启 - 执行前务必保存文件（
Ctrl+S）。data-atom只读取磁盘上已保存的文件内容，不读取未保存的编辑缓冲区 - 选中部分语句执行？必须用鼠标**完全选中**（包括末尾分号），且不能跨多行选中间断开——它不支持片段执行，只支持完整语句或整个文件
查询结果卡死或只显示前 10 行？这不是 bug，是设计限制
data-atom 的结果面板用 Atom 原生 DOM 渲染表格，大数据量（比如 SELECT * FROM big_table）会直接拖慢甚至冻结编辑器。这不是配置问题，也别折腾“增大内存”——它压根没提供分页或流式加载。
- 强制加
LIMIT 100：哪怕你确定数据就 50 行，也养成习惯，避免某次手滑漏写 - 清空上次结果再查：按
Ctrl+Shift+P→ 输入Data Atom: Clear Results，不然新结果会追加在旧结果下面，越积越多 - 导出替代查看：右键结果表格 →
Export as CSV，用 Excel 或 VS Code 打开，比在 Atom 里滚动安全得多 - 复杂分析别硬扛：涉及 JOIN、GROUP BY 或上万行结果时，直接切到终端用
mysql -u root -p -e "SELECT ..."，Atom 只负责写和初筛
真正麻烦的不是连不上，而是连上了却误以为“能当全功能客户端用”。data-atom 是轻量辅助工具，不是 DBeaver 替代品——接受这个边界，才能少踩一半坑。
