第56章 TablePlus 常见问题故障排除指南
实用工具 故障排除 这里列出了一些常见问题及其解决方法。 连接窗口被隐藏 问题:新窗口打开了,在 Mission Control 里能看到,但屏幕上就是不显示。 解决方法:退出 TablePlus,打开 Terminal,运行下面的命令删除应用的偏好设置文件。这会重置部分应用设置,但连接信息保存在另一个文件中,不会受影响。 rm ~/Library/Preferences/com.tinyapp.TablePlus.plist
无法通过 SSH 连接 问题:连接设置没问题,但就是无法通过 SSH 隧道连接。 解决方法:开启 SSH 日志并发送给我们,以便更快排查:
选择 Help > Enable SSH & Bash Script Log。
退出 TablePlus。
打开 Terminal,从命令行启动 TablePlus 查看日志: /Applications/TablePlus.app/Contents/MacOS/TablePlus
重新连接,然后把日志输出发送到 [email protected]。
安装包损坏 问题:在 macOS 上安装应用时,出现 "The package is damaged" 错误。 解决方法:很可能是你的 macOS 版本不受支持。TablePlus 需要 macOS 12 或更高版本,请先升级系统。 表格数据显示错误 问题:打开表格时,部分字符显示不正确。 解决方法:使用正确的编码。选择 Connection > View Using Encoding,然后选择与表格匹配的编码。 查询结果被隐藏 问题:在 SQL 编辑器中运行查询,但结果面板没有显示。 解决方法:按 ⌃ + `,或选择 View > Toggle sidebars > Toggle Query Results Pane。也可以把查询编辑器的下边缘往上拖。 结果面板被折叠 无法导入 CSV 问题:从 CSV 文件导入数据时,中途报错导致导入失败。 解决方法:通常有两个原因:
编码错误:在 Import CSV Wizard 中换一个 Encoding 再试。 数据类型不匹配:导入前检查数据,确保数据类型与表格列匹配。
更简单的办法是导入到一个所有列都是文本类型的新表,这几乎每次都能成功。在 Import CSV Wizard 中勾选 Create new table,并选择 Create table with all text Columns。 导入到全文本列的表格 许可证无效 问题:许可证密钥是有效的,但激活时显示 "Invalid license key:",后面跟着密钥。 解决方法:这种情况通常是密钥被粘贴了多次。清空输入框,从邮件中重新复制完整的许可证密钥,只粘贴一次。 AI 助手没有响应 问题:在 Assistant 标签页发送消息后,报错或没有回应。 解决方法:
检查 Settings > AI Agent 中该服务商是否配置了 API key。Ollama 虽然不使用 API Key,也需要填一个值。 对于 Codex CLI,检查 Settings > AI Agent > Codex CLI 中的 Status。如果找不到 Codex,在 Path 中填写 codex 可执行文件的完整路径。 对于自定义 agent,点击 Test Agent 确认 TablePlus 能正常启动它。 确认网络没有屏蔽该服务商。
详情参见 LLM Plugin。