源码系统概览
文章正文
Jasmine 是一款基于 Typecho 的响应式博客主题，专为博客类网站开发，适合用来搭建个人技术博客。
界面走简洁路线，细节上却尽量做得精致美观，移动端的响应式适配也专门打磨过。
作者在 SEO、夜间模式、代码高亮这些地方都做了针对性优化，页面看着简单，用起来不单薄。
源码简介
Jasmine 由作者 Kent Liao 开发和维护，以 GPL V3.0 协议开源，当前版本为 2.5.5。
整包共 39 个文件，压缩包不到 1MB，解压后传到 Typecho 的 usr/themes 目录就能启用。
主题整体采用响应式设计，在手机、平板和桌面端都能获得一致的阅读体验。
内置功能覆盖日常用得到的部分，夜间模式、无刷新跳转页面、代码高亮这些都在里面。
还有说说、随机文章跳转、置顶、阅读量统计和评论 QQ 头像这些展示类功能。
外观设置支持一键备份，主题更新也能自动检测，维护成本不高。
官方提供了演示站点和详细主题文档，可以直接下载安装使用，也可以依据文档二次开发。
适用场景
Jasmine 非常适合搭建个人技术博客，用来记录学习笔记与开发经验。
生活随笔类站点也可以直接使用，简洁的排版能让文字内容更加突出。
摄影、读书、影视这类兴趣站点同样适用，视觉上干净清爽。
相比 Typecho 自带的默认主题，Jasmine 把夜间模式、代码高亮、无刷新跳转这些体验做成了开箱即用的功能，不用自己改模板。
开发者还可以在 GPL V3.0 许可下进行二次开发，做出自己的专属主题。
功能亮点
主题针对搜索引擎做了优化，独立页还能单独设置关键词字段，对收录排名更友好。
支持夜间模式，亮色暗色随时切换，晚上看文章不刺眼。
点击文章不整页刷新，浏览起来更连贯，等待时间也短了不少。
内置代码高亮功能，配合一键复制按钮，贴技术文章里的代码片段很顺手。
说说功能和随机文章跳转都有，博客的展示形式更丰富。
评论能显示 QQ 头像，文章带阅读量统计，还能置顶，日常运营省不少事。
外观设置可以一键备份，主题更新也会自动检测，后续维护很省心。
相比 WordPress 生态里动辄几兆到几十兆的博客主题，Typecho 本身更轻量，Jasmine 整包不到 1MB。
技术架构与部署指南
| 维度 | 本套源码 | 同类通用方案 |
|---|---|---|
| 技术栈 | 前端：HTML5与Tailwind CSS响应式布局，配合PrismJS实现代码高亮与复制。 | 依具体方案选型，需自行搭建与维护 |
| 部署方式 | 把主题文件夹上传到 Typecho 的 usr/themes 目录，确认文件夹名称正确。 | 多托管于第三方平台或订阅云服务 |
| 功能侧重 | 主题针对搜索引擎做了优化，独立页还能单独设置关键词字段，对收录排名更友好。 | 功能通用，定制深度有限 |
| 数据归属 | 数据自持，部署在自有服务器，不出站 | 数据通常留存于服务商侧 |
| 成本模式 | 获取后自主部署，无持续授权费用 | 通常按订阅或调用量计费 |
技术栈与运行环境
前端：HTML5与Tailwind CSS响应式布局，配合PrismJS实现代码高亮与复制。
后端：PHP语言，基于Typecho博客系统开发。
数据库：Typecho系统默认支持的SQLite或MySQL数据库。
运行环境：PHP 7.x以上版本并安装Typecho，服务器需支持伪静态配置。
其他依赖：Node.js与pnpm仅用于开发构建，日常使用主题无需额外依赖。
安装与部署提示
把主题文件夹上传到 Typecho 的 usr/themes 目录，确认文件夹名称正确。
登录 Typecho 后台，在控制台的外观页面启用 Jasmine 主题即可。
外观设置里可以配置导航菜单、侧边栏、夜间模式、缩略图这些常用选项。
如果开了伪静态链接，记得检查服务器 Rewrite 规则，保证文章和独立页能正常访问。
部署完建议清一次缓存，再用手机看看页面，确认响应式布局正常。
截图与演示说明
首页由 index.php 驱动，通过 component 目录下的 sidebar-left、menu、post-item、post-top 和 paging 组件组合出完整的文章列表布局。
右侧 sidebar.php 展示侧边栏信息，post-item.php 负责文章条目的缩略图、标题与摘要展示。
文章详情页由 post.php 提供，配合 core/meta.php 实现阅读量统计与文章缩略图读取。
独立页模板包括归档页 page-archives.php、友链页 page-links.php 与随机文章页 page-random.php，功能划分清晰。
评论模块由 comments.php 实现，支持多层嵌套评论、博主高亮与 QQ 头像显示。
主题还内置了 404.html 与 404.php 两个错误页面，结构直观完整，便于直接体验和二次修改。
常见问题
问：安装后前台提示主题缺少必要文件，应该如何处理？
请确认主题文件夹完整上传到 usr/themes 目录，且文件夹名与主题一致。
确认无误后，再重新启用一次主题。
问：代码高亮和夜间模式不生效怎么办？
可以先在后台外观设置中确认相关开关已开启，并清理浏览器缓存后重新查看。
问：启用后页面出现乱码或样式错乱？
请检查 Typecho 与 PHP 版本是否满足要求，同时确认站点配置的字符编码为 UTF-8。
问：Jasmine 和 Typecho 自带的默认主题有什么区别？
默认主题偏功能演示，Jasmine 针对阅读体验做了专门设计。
夜间模式、代码高亮、无刷新跳转、说说这些功能，在默认主题里都要另外折腾。
问：Jasmine 需要单独建数据库吗？
不需要。
主题本身不带数据库，数据由 Typecho 系统默认的 SQLite 或 MySQL 存储。
启用主题后直接在后台写文章即可。
安全风险提示
发布方未对本套源码做逐文件安全检测，下载后请自行完成安全审计。
部署前重点检查 functions.php 和 core 目录里的 PHP 脚本，确认没有可疑的外链请求，删除恶意代码后再启用主题。
下载说明
本文介绍的 Jasmine Typecho 博客主题源码已整理打包，供大家下载学习研究。
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
主题以 GPL V3.0 协议开源，二次开发时请遵守协议要求并保留主题名称及链接。
本套主题由奥森免费源码网整理分享。
最后更新：2026-08-16