企业官网建设流程全解析

Wiki.js 主题挑选与安装指南：新手快速完成外观定制

【免费下载链接】wiki-Wiki.js | Next Generation Open Source Wiki项目地址: https://gitcode.com/GitHub_Trending/wiki78/wiki-

刚部署好的 Wiki.js 默认界面偏素。这篇指南按使用场景给 Wiki.js 换主题定档位，用 4 个维度筛掉不合适的外观方案，后台 5 步或两条命令完成主题安装，装完先验收，出故障按表排查。

先定档位：给谁看，就改多少

改外观前先定档位：改多了浪费精力，改少了不够用。

官方默认主题就在仓库的 server/themes/default/ 里，配置项只有强调色、目录位置这类几个开关，上手门槛比多数 CMS 低很多。

选主题，只盯 4 个维度

每个维度按 2 分制打分（0 = 不满足，1 = 勉强，2 = 达标），两项带否决权：

💡 观感和维护状态是一票否决项，性能和功能两项只要二选一达标即可。

后台 5 步切换主题（推荐路线）

有界面操作就不碰文件，登录后走这条线：

1. 登录管理后台，进入主题设置页（该页面的前端实现见 admin-theme.vue）
2. 选择主题与图标集
3. 配置 TOC（页面目录）位置和深色模式
4. 需要品牌色微调时，在注入 CSS里覆盖样式变量，而不是改主题源码
5. 点击应用，回到前台验证

⚠️ 应用前把当前配置截图留底，万一想回滚，能省不少事。

手动安装第三方主题的两条命令

需要装第三方主题包时走文件层面，在你自己的服务器上执行（≤2 行）：

cp -r my-theme /path/to/wikijs/server/themes/ chmod -R 755 /path/to/wikijs/server/themes/my-theme

重启服务后回后台选择新主题。为什么权限要提前设 755：读不到文件时前台多半只是白屏配一行 404，事后追因的代价远高于现在敲一条命令。

装完先验收，再谈上线

验收动作按这个顺序过：

1. 桌面端：长文滚动、侧边栏、目录是否齐全
2. 移动端：换窄屏或真机看排版，断点没适配的主题别上线
3. 代码块：高亮生效、横向滚动正常
4. 目录（TOC）：点锚点能准确跳转
5. 搜索：结果页样式没被主题破坏

发布前再勾一遍这 5 条，能避开大部分返工：

• 档位匹配：个人/团队/企业，改动幅度对得上需求
• 维护状态：主题近半年有更新，作者在线可响应
• 验收完成：桌面 + 手机都看过，代码块、目录、搜索都正常
• 定制留退路：改动只走注入 CSS 或独立分支，没动主题源码
• 回滚方案：当前主题名和配置有截图留底，5 分钟内能切回默认

出问题时，按顺序查这 5 处

版本冲突这一行的本质，是主题的requirements声明（主题配置文件 theme.yml 的格式可参考 theme.yml）与站点当前版本对不上，区间声明到位，升级站点时就不会莫名其妙崩掉。

换主题这件事不难，难的是动手前想清楚三件事：给谁看、改到什么程度、谁长期维护。把上面的档位、维度和清单走完一遍，你拿到的就不只是新皮肤，而是一套能长期跑的外观方案。✅

【免费下载链接】wiki-Wiki.js | Next Generation Open Source Wiki项目地址: https://gitcode.com/GitHub_Trending/wiki78/wiki-