OneNav主题切换完全指南：3步换肤，让PC和手机各用各的界面

【免费下载链接】onenav使用PHP + SQLite 3开发的书签管理系统，将浏览器书签集中式管理，做到一处部署，随处访问。项目地址: https://gitcode.com/gh_mirrors/on/onenav

如果你还在用浏览器自带的收藏夹，把几百个网址堆在同一个下拉菜单里，大概早就体会过那种"想找一个网站、翻了半分钟"的焦躁感。而当你换了电脑、换了手机，那些书签又不会自己跟过来。OneNav 就是这样一款用 PHP + SQLite 3 写成的书签管理系统，一处部署、随处访问，而它内置的多主题机制，则让你在管理书签之外，还能顺手把整个导航页打扮成自己喜欢的样子。这篇 OneNav 主题设置教程会带你从零开始，在十几分钟内完成一次漂亮的换肤。

一个真实场景：为什么你的导航页需要"换脸"

想象一下：你的 OneNav 部署好后，同事们每天打开首页，看到的是默认的蓝色调 Material 风格页面。页面没什么不好，但总觉得缺了点个性。更麻烦的是，手机上的效果和电脑上完全一样——字体小、按钮挤，触屏点起来很费劲。

这时候你需要的不是"再买一个网站系统"，而是一次主题切换。OneNav 把"界面外观"和"书签数据"彻底分离：换主题，本质上只是换了一件外套，你的分类、网址、点击量统计一概不动。这也是很多人敢反复折腾主题的原因——随时换、随时回退，数据零风险。

先认识五位"现成选手"：内置主题怎么选

打开 OneNav 的 templates 目录，你会看到几个开箱即用的主题目录，每个都自带完整的页面模板和样式文件。它们的分工大致如下：

选主题不用太纠结：先用 default2 起步，它是目前功能最完整的默认主题，基本能覆盖九成需求；如果你偏爱极简，再切到 minima 感受一下。

第一次换肤实操：PC 与手机分开设置的两步清单

OneNav 主题切换最贴心的一点，是电脑端和手机端可以各自独立选主题。比如办公室大屏用 default2 展示完整信息，手机端换 mobile 主题保证触屏体验，两者互不干扰。

具体操作只要两步：

1. 进入主题设置页：登录 OneNav 管理后台，在左侧菜单找到"设置"，进入"主题"选项。页面上方是两个下拉框——"PC主题"和"手机主题"。
2. 分别选定并保存：先给 PC 选一个，再给手机选一个，点击"保存"按钮，后台会自动把配置写入数据库，不用改任何代码。

如果你只是想临时看看某个主题长什么样，不用动全局配置——在首页 URL 后面直接加?theme=主题名就能即时预览，这个技巧在正式切换前特别有用，可以逐个主题"试穿"。

换完皮肤后的三个"隐形坑"与补救办法

第一次换主题，很多人会遇到下面几个小状况，提前知道就能少走弯路：

• 页面还是老样子？大概率是浏览器缓存作祟，不是设置失败。按Ctrl+F5强制刷新，或清一次缓存再打开。
• 想反悔回到默认？在主题设置页把 PC 主题和手机主题都改回default，保存即可，整个过程不碰任何数据。
• 某主题显示异常？先别急着删。确认 OneNav 程序版本是否满足该主题 info.json 里标注的require.min版本要求——旧程序跑新主题，偶尔会出现兼容问题。

每个主题背后的"遥控器"：参数设置到底在调什么

打开任意主题卡片，你会发现一排操作按钮：详情、参数设置、更新、预览、删除。其中**"参数设置"是最容易被忽略、却最能出效果的功能**。

点进去后，你会看到一组主题自带的配置项，常见的有：

• full_width_mode：是否开启全宽模式，关闭时内容居中、留白更多，开启时页面铺满整个屏幕。
• link_description：控制导航链接下方是否显示描述文字，信息密度全靠它调节。
• favicon：站点图标的来源方式，可选在线获取或本地存储。

这些参数的默认值都写在主题的 info.json 配置文件中，你在后台修改后会自动覆盖默认值。小提示：如果你不清楚某个参数的含义，先保持默认不动，等熟悉了再慢慢调。

进阶玩法：手搓一套自己的主题

内置主题玩腻了？OneNav 的自定义主题门槛低到超乎想象，核心就四个字：复制、修改。

1. 复制一份基础：把 templates 里任意一个主题目录整个复制，改成一个新名字（例如mytheme）。
2. 改页面结构：编辑新目录里的index.php，调整布局、增删区块。
3. 改视觉风格：修改style.css等样式文件，配色、字体、间距全由你定。
4. 更新主题信息：编辑info.json，填好主题名称、版本号、描述——这个文件就是主题的"身份证"，后台就是靠它识别和展示主题的。
5. 测试并上线：把新目录放进 templates 后，回到后台主题页，它就会出现在"已下载"列表里，直接预览、启用。

如果你觉得动手改代码还不过瘾，后台还有"在线主题"区域，可以直接浏览和下载社区分享的主题。需要说明的是：主题本身免费，但主题的下载与更新需要订阅用户身份才能使用，这是为了分摊服务器的存储和带宽成本，理解一下就好。

关于换主题，大家最常问的几个问题

• 换主题会不会弄丢我的书签？不会。主题只负责"长什么样"，书签数据存在数据库里，两者完全隔离。
• 能同时用两个以上的主题吗？可以。PC 和手机各用一套，这就是设备自适应；如果你再部署一个测试环境，想放几套放几套。
• 怎么知道主题有没有新版？后台主题页会自动检测并标出"可更新"的主题，一键更新即可，无需手动下载覆盖。
• 主题切换会影响访问速度吗？会有一点点，但几乎无感。主题只是前端模板，真正的数据查询逻辑和数据库操作完全不变。

现在就去动手吧

回头看，换主题这件事的性价比实在太高：不动数据、不写代码，几分钟就能让整个导航页焕然一新，还能让 PC 和手机各取所需。建议你现在就登录后台，用?theme=预览的方式把每个内置主题都看一遍，选中合眼缘的保存启用——不满意随时切回来。

如果在折腾的过程中遇到报错或效果不如预期，别慌，先查官方文档里的主题设置说明，或去社区搜一搜同类问题，大概率有人已经踩过同一个坑。祝你换肤愉快，早日把导航页打扮成自己喜欢的样子！

【免费下载链接】onenav使用PHP + SQLite 3开发的书签管理系统，将浏览器书签集中式管理，做到一处部署，随处访问。项目地址: https://gitcode.com/gh_mirrors/on/onenav