Puock 高颜值 WordPress 主题 v2.10.2 整站包:官方 GitHub Licoy/wordpress-theme-puock v2.10.2 tag 干净无后门,GPL v2 开源。附 4 件套:整站主题源码(10.8MB / 481 文件 / 23 Option 模块)+ 中文 README 完整说明 + USAGE 21 项功能指南 + screenshot 主题截图。需要先装 WordPress 主程序,主题解压后改名 puock/ 放到 wp-content/themes/。

Puock 高颜值 WordPress 主题 v2.10.2 整站包（GitHub 官方源 + 中文使用指南）——WordPress 默认主题 Twenty Twenty-Four 丑到劝退,主题市场一搜全是付费版,GitHub 上 Puock 是少数 1.2k stars 的开源高颜值主题,深色模式 + 多端适配 + 后台设置面板几乎全有。但 clone 下来的源码你不知道"主题"装到 wp-content/themes/ 才能用,本文附 GitHub 官方 Puock v2.10.2 tag 整站源码 + 中文 README + USAGE 详细使用指南 + 启动检查表,4 件套打包解压即装。

Puock 高颜值 WordPress 主题 v2.10.2 整站包（GitHub 官方源 + 中文使用指南）

本指南 3 大卖点:
 ✓ 官方源 v2.10.2 — zip 来自 GitHub Licoy/wordpress-theme-puock v2.10.2 tag,与官方一模一样,无后门,GPL v2 开源协议
 ✓ 中文 README + USAGE — 中文使用说明 + 友情链接 / 提示框 / 短代码 / 可见性详细指南(共 21 项功能)
 ✓ 真轻量 — 含 481 个文件,核心 1 个 functions.php 31KB,主题面板 23 个 Option 类模块化设计

为什么这件事值得做

• Twenty Twenty-Four 默认主题太丑:WordPress 装好默认是这个,想做技术博客/资讯站立刻劝退

• 主题市场付费版贵:一份 Puock 主题市场卖 ¥99-299,GitHub 官方源是开源免费的

• GitHub clone 下来跑不起来:Puock 是 WordPress 主题目录,不是独立站点,得先装 WP 主程序,新手第一步卡死

• GitHub zipball 带 commit hash 目录:解压后目录名是 Licoy-wordpress-theme-puock-abc1234/,WP 不认,得手动改成 puock/,本 zip 已处理

5 个挑选 / 避坑思路

实战场景:你用的是虚拟主机 PHP 7.4 + MySQL 5.7,WordPress 6.5 已装好,想换主题做技术博客。下面 5 招围绕"Puock v2.10.2 上线部署"展开。

// Puock v2.10.2 部署 5 段伪代码（按 README + USAGE 顺序）

/* 第一段:把 zip 解压到 themes 目录 */
cd /var/www/html/wp-content/themes/
unzip puock_v2.10.2.zip
mv Licoy-wordpress-theme-puock-xxx puock       // 改名为 puock/
ls puock/
// 应该看到:style.css  functions.php  index.php  README.txt  USAGE.txt

/* 第二段:WP 后台启用主题 */
https://yourdomain.com/wp-admin/themes.php
// 找到 "Puock" 主题 → 启用

/* 第三段:主题设置面板（首次必设） */
Puock 主题 → 全局设置
- 主题模式: 浅色 / 深色 / 跟随系统
- Logo 上传: 200x60 PNG
- 备案号: 京 ICP 备 xxxxxxxx 号

/* 第四段:启用友情链接（USAGE 第 1 节） */
Puock 主题 → 链接管理
- 启用 WordPress 内置 Links
- 添加友情链接 → 发布

/* 第五段:启用提示框（短代码） */
[puock alert type="success"]已成功部署 Puock[/puock]
[puock alert type="warn"]注意:深色模式需浏览器支持 prefers-color-scheme[/puock]

• 第 1 招[判断标准]:认准 GitHub Licoy/wordpress-theme-puock 官方仓库的 v2.10.2 tag,不要下 master 分支(可能不稳定)

• 第 2 招[避坑点]:Puock 是 主题目录(wp-content/themes/puock/),不是独立站点!必须先装好 WordPress 主程序才能用

• 第 3 招[关键参数]:WordPress ≥ 5.5 + PHP ≥ 7.0,低于这个主题设置面板进不去,白屏报错

• 第 4 招[易踩坑]:解压后 必须把内部 puock 目录提到 wp-content/themes/,整个 zipball 解压目录结构带 hash,WP 主题识别要纯 puock/

• 第 5 招[场景建议]:先在 WP 后台切到 Puock 主题 + 启用默认外观 → 通过后再启用友情链接 / 提示框等 USAGE 高级功能,免得设置面板冲突

5 个避坑点（踩过就懂）

• Puock 当成独立站点打开 — 这是 WP 主题,必须先装好 WordPress 主程序

• 解压后目录名带 commit hash — 必须重命名为 puock/,否则 WP 不识别

• WordPress < 5.5 + PHP < 7.0 — 主题设置面板进不去,白屏报错

• 直接下 master 分支 — master 可能带未发布代码,先看 tag 选稳定版

• 启用主题后立刻改主题配置 — 先切到默认外观通过测试,再启用 USAGE 高级功能

📦 2026-07-25 更新:zip 已处理成「无 md 版」(.md 全部转 .txt),打开即用,无 markdown 文件残留。

下载包里有什么（4 件套,跟 zip 一一对得上）

为什么必须下载:相比 GitHub zipball(目录名带 commit hash,WP 不认),这个包多了 已重命名为 puock/ 的目录 + 中文 USAGE 详细指南(21 项功能不是英文 README 一句话带过)。装好主题照着 USAGE 启用友情链接 / 提示框 / 折叠面板等高级功能,90% 的人不会卡在"主题切了但功能找不到"。

一句话总结:整站主题包 = 干净无后门 v2.10.2;README.txt = 主题完整说明;USAGE.txt = 21 项功能攻略;screenshot.png = 主题预览。光看文章懂思路不会装,光有源码不会用,4 件套必须一起下。