uWeb 中文文档 下载 App

网站样式异常或布局错乱怎么办

排查清单

1. 是不是关了图片或 CSS

这是最常见也最容易忽略的问题:

临时恢复:长按设置 → 恢复默认(或长按窗口管理取消所有特殊模式)。

2. 检查 UA 伪装是否合理

某些网站在"手机 UA"和"PC UA"下返回完全不同的页面结构:

排查:长按设置 → 浏览器标识 → 切回默认 UA 测试。

3. sitecss 里的自定义样式误伤

如果你在 sitecss/ 里写了对该域名的自定义 CSS,可能里面的规则太激进:

排查:

  1. 暂时移走 sitecss/[域名].css
  2. 重启后测试
  3. 如果恢复正常,说明自定义样式误伤了,需要精简规则

4. default.css 兜底样式干扰

如果访问的域名在 sitecss/ 里没有匹配的 CSS,uWeb 会用 default.css 兜底。如果 default.css 写了激进的全局规则(如夜间模式 CSS 过强),可能把本该保持原样的网站也改了。

排查:

  1. 暂时移走 default.css
  2. 重启后测试
  3. 如果恢复正常,说明兜底样式影响了这个网站的正常显示

5. 全局重定向或资源重定向导致 CSS 被替换

如果开了全局重定向或资源重定向,检查:

排查:

  1. 暂时关掉全局重定向
  2. 暂时关掉资源重定向
  3. 重启后测试
  4. 如果恢复正常,检查重定向规则里的 CSS 相关域名

6. sitecss 下的前置 JS 有错误

sitecss/ 下以域名命名的 .js 文件会在 HTML 解析前执行。如果这个 JS 有错误(比如劫持了 DOM API),可能影响后续样式加载。

排查:

  1. 暂时移走 sitecss/[域名].js
  2. 重启后测试

7. JS 被禁用导致样式缺失

某些现代网站(尤其是 SPA)的样式是在 JS 执行后动态注入的。如果:

排查:

  1. 长按设置 → 确保脚本未被禁用
  2. 检查 default.hosts 没有拦截 CSS/JS CDN 域名(如 cdnjs、unpkg、jsdelivr、fontawesome 等)
  3. 检查 js.allow 白名单里有没有放行必要的域名

8. 缓存问题

有时候 uWeb 的缓存里存了旧版或损坏的资源:

系统方法

如果以上方法都没找到原因,按顺序做:

  1. 最小化环境:关掉所有重定向、关掉 sitejs/sitecss、关掉所有浏览模式、切回默认 UA → 重启 → 看网站能不能正常显示
  2. 逐步恢复:每次只加回一层配置 → 重启 → 看哪一步开始出问题
  3. 定位到配置文件:一旦定位到是某层的问题,再深入排查那层里的具体规则

下一章