竹山一叶

Hexo博客上手入门指南、性能优化、界面美化、扩展功能、各种疑难杂症等解决方案全系列合辑（持续更新中……）

Hexo+Butterfly操作指南、美化方案和优化教程全系列合辑（持续更新中……）

Nginx安装、部署、配置和相关问题处理（持续更新中……）

SSH、Git、Github使用系列指南（持续更新中……）

收纳和整理常用开发工具优化技巧、功能设置方法、以及常见问题（持续更新中……）

hexo clean 跑了十几分钟还没删完, 换 rm -rf 只要 5 秒? 这不是你机器的问题。根因是 hexo-fs 的删除实现用无并发限制的 map 递归删文件, 在 Windows 的文件句柄排队机制下被放大成假死。本文给出量化的对比数据、根因分析和跨平台的替代命令。

源码一切正常, 本地预览没问题, 构建发布后某个交互组件崩了, 而 gulp 的构建日志一片绿? 老压缩链 gulp-uglify / gulp-htmlmin 有两个经典坑: uglify-js 只支持 ES5 会静默损坏 ES6 代码, html-minifier 遇到未转义尖括号会中止整个流程。本文给出迁到 terser 的完整改造方案, 附单文件容错的 gulpfile 模板。

部署 pdf.js 的 viewer.html 后, 页面打开只有一条灰线, DOM 元素全在却高度为 0? 根因是 viewer 被静态站点生成器渲染进了主题模板, height:100% 的高度链断了。本文给出 skip_render + 根绝对路径 + 开新窗口的完整解法, 以及"量尺寸而非数元素"的调试方法。

pjax 站点里, 只在特定页面加载的第三方组件 (如 APlayer 播放器) 经常"直开正常, 站内跳转进来就坏"。本文讲透背后的三个机制: head 不替换、相对路径按来源页解析、exclude 拦不住进入方向的跳转, 并给出一套通用的兜底脚本写法。

npm install 卡住、超时、报ETIMEDOUT? 这篇按"先定位再解决"的顺序, 讲清镜像源怎么选、镜像源失效怎么发现、超时参数怎么调、代理与镜像源为什么冲突, 以及 pnpm/Docker 场景下的同类问题。