phpMyAdmin 5.x书签功能保存高频SQL语句

使用 phpMyAdmin 5.x 的朋友可能会发现，书签功能并非默认开启。它就像一扇需要特定钥匙才能打开的门，必须同时满足三个硬性条件，那个“添加书签”的按钮才会乖乖现身。

具体是哪三个条件呢？

• 你必须成功执行过一条返回结果集的查询，比如 SELECT 语句。
• 左侧数据库列表中，必须有一个数据库处于选中并高亮的状态。
• 服务器后台必须开启 bookmarktable 这个配置项。

这三个条件缺一不可，否则你翻遍整个页面也找不到那个“Add bookmark”选项。

书签入口消失不见？这不是 Bug，而是设计逻辑

很多新手都会问，为什么书签入口点不出来？其实这完全是设计逻辑在起作用。书签入口只会在你成功执行一条返回结果集的查询后出现，它就静静待在结果表格的正下方。

• 只有 SELECT 类查询能触发。像 INSERT、UPDATE、DELETE 这些不返回数据行的操作，是不会显示这个区域的。
• 如果你在空查询框里直接点执行，系统会报错，自然也不会显示入口。
• 左侧数据库列表必须高亮，否则按钮就是灰色的，点了也没反应。

所以，如果你看不到入口，请按这个清单自查：确认刚执行的是类似 SELECT id, name FROM users LIMIT 10 的语句；检查左栏的数据库名是否高亮；再到右上角“Settings” → “Features” → “Bookmarks”里确认状态是否为 Enabled。

变量填值？认准这一种语法

phpMyAdmin 对变量占位符的语法有严格偏好，它只认一种格式：/*[VARIABLE]*/。一定要全大写、不能有空格、得用星号和斜杠包裹起来，而且变量名只能由字母、数字和下划线组成。

• ✅ 正确示例：WHERE status = /*[STATUS]*/ AND created_at > /*[SINCE]*/
• ❌ 无效示例：WHERE id = $id（PHP 风格）、WHERE id = {id}（其他框架风格）、WHERE id = /*[user_id]*/（小写了）、WHERE id = /*[USER ID]*/（带了空格）
• 如果在同一条 SQL 语句里重复使用同一个变量名，比如两个 /*[ID]*/，运行时只会弹出一个输入框，你填的值会自动同步到两个位置。
• 即使你写了占位符但在 SQL 里根本没用到那个字段，phpMyAdmin 也不会校验，它还是会强制你填一下。

保存后找不到或执行失败？问题出在这儿

很多朋友保存了书签，下次却找不到了，或者执行失败。需要注意：书签并不是全局可见的，它和创建时所在的数据库绑定。而且它依赖一个叫 pma__bookmark 的系统表来存储，一旦权限或配置有问题，就会静默失败，你完全看不到任何提示。

• 当你切换到另一个数据库后，之前保存的书签不会自动出现。它只对创建它的那个 db_name 可见。
• 在共享环境（比如虚拟主机）下，管理员可能出于安全考虑禁用了 bookmarktable。这时你点击“Add bookmark”按钮毫无反应，控制台也看不到报错。
• 书签列表只会在“SQL”页面的底部显示，首页、结构页、导入页这些地方都看不到。
• 如果你想跨库复用这个查询，唯一的办法就是在每一个目标数据库下，分别执行一次相同的查询并保存一次。

别想着导出单个书签文件，它存在数据库里

最后提醒一点：phpMyAdmin 的书签数据是存储在 MySQL 的 pma__bookmark 表中的，它不是一个独立的 .sql 文件。你没法像导出单个 .sql 文件一样把它带走。如果想迁移或备份你的书签，需要用 phpMyAdmin 自带的“Export”功能，选中这张表单独导出。

还有一个容易忽略的小细节：书签模板保存后，如果你后续想修改它，只能通过“Bookmarks”页面里的编辑按钮来操作。如果你直接在 SQL 输入框里改了语句，再点“Create bookmark”，这不会覆盖旧书签，而是会新建一条记录。