左侧树状菜单宽度不保持，因localStorage未在DOMContentLoaded后读取并应用，或flex布局下直接改style.width被覆盖；应改用CSS变量+setProperty、避免!important、移动端需加媒体查询适配。
左侧树状菜单宽度不保持？localStorage没读回来或没生效
拖拽调整后宽度复位，不是 bug，是默认逻辑没触发“读取并应用”。phpmyadmin 5.x 的左侧导航栏（.navigation 或 #serverinfo 下的 .sidebar）靠 js 控制宽度，但只存不读，或者读了却没正确设到 dom 上，就会失效。
关键点：必须在 DOMContentLoaded 后读取 localStorage.getItem('navWidth')，再设给容器。不能等 window.load，否则页面已渲染完毕，样式来不及介入。
- 检查是否用了
flex布局——如果父容器是display: flex，直接改element.style.width会被 flex 弹性拉回，应配合flex: 0 0 var(--nav-width, 220px) - 存值时用整数像素（如
'240'），别存带单位的字符串（如'240px'），JS 里拼接更安全 - 避免在
mousemove中直接写style.width，改用requestAnimationFrame批量更新，防卡顿
硬写 CSS 强制宽度导致拖拽失效？别碰 !important 和 width 内联冲突
加了 .sidebar { width: 220px !important; } 后拖拽手柄完全不动，是因为拖拽逻辑靠 JS 动态写 style.width，而 !important 锁死了该属性的覆盖能力。
真要设定最小/最大宽度，优先用 min-width/max-width，它们不干扰 JS 的内联 width 更新；更推荐用 CSS 自定义属性 + JS 配合：
- 在 CSS 中定义：
.sidebar { flex: 0 0 var(--nav-width, 220px); } - JS 中更新：
document.documentElement.style.setProperty('--nav-width', '240px'); - 这样既保留拖拽响应，又避免 flex 布局重算错乱
移动端小屏下菜单被压扁或换行错位？媒体查询必须加 flex-wrap 和 display: block
手机上左侧菜单文字挤成一团、图标错位，不是字体问题，是默认 CSS 对 .navbar 和 .navigation 没做小屏适配。5.x 版本虽带 responsive 主题，但只对部分页面生效，且依赖 JS 初始化，在禁用 JS 或老旧 WebView 下直接失效。
立即学习“PHP免费学习笔记（深入）”；
直接改 css/common.css，在 @media (max-width: 768px) 块里补三处：
-
.navigation { flex-wrap: wrap; justify-content: flex-start; }—— 防顶部导航塌陷 - 把所有含
float: left的类（如.left、.right）改成display: block; width: 100%;—— 防按钮重叠 -
.navigation .container { white-space: nowrap; overflow-x: auto; }—— 防数据库名被截断
改完清浏览器缓存，或 URL 后加 &v=2 强制刷新 CSS，否则可能还在用旧哈希版本。
为什么改了 CSS 还是没变？路径、缓存、加载顺序全得对上
最常踩的坑不是代码写错，而是文件没加载进来。phpMyAdmin 5.x 支持 $cfg['CustomCSS'] 注入，但路径必须是 Web 可访问路径（不是服务器绝对路径），且文件得放在能被 HTTP 直接请求到的位置。
- 别写
/var/www/html/phpmyadmin/css/custom-pma.css，应写css/custom-pma.css，然后把文件放 phpMyAdmin 根目录下的css/子目录里 - 在 Chrome 开发者工具的 Network 标签页确认该 CSS 文件状态码是 200，且在 Elements 中能看到规则被加载、未被
!important覆盖压制 - 如果用了 Nginx 或 CDN，检查是否启用了
expires缓存指令，临时关掉再试
拖拽记忆和 CSS 适配其实是两个独立系统：前者靠 JS + localStorage，后者靠 CSS + 媒体查询。调一个漏一个，界面在桌面和移动端就永远“差一口气”。
