博客优化日记 —— 2026年6月6日

今天对博客进行了一次全面的优化和维护，从安全问题到用户体验，从内容完善到国内访问加速，前后经历了多次调整。记录一下这次大整理的过程。

🛡️ 安全清理

博客之前配置了 Gitalk 评论系统，但在配置文件中硬编码了 OAuth 的 clientSecret，同时项目目录下还残留了包含 GitHub 私人访问令牌的文档文件。

处理方式：

• 删除含令牌的文档文件
• 清除主题配置文件中的 clientID、clientSecret
• 清除公共代理（corsproxy.io）配置

提醒： 配置文件中的敏感信息应使用环境变量或单独的管理方式，避免提交到代码仓库。

🔧 配置修复

部署配置

之前 _config.yml 中的 deploy.type 为空字符串，无法使用 hexo deploy 一键部署。现已配置为 Git 部署方式，安装了 hexo-deployer-git 插件。

站点 URL

博客实际部署在自定义域名 https://demo-blog.qusite.cn，但配置文件中一度被改为 Gitee Pages 的默认地址，导致页面资源路径错误。已修正。

资源路径修正

• Favicon：主题引用的 /images/favicon.svg 不存在，改为存在的 defaultone-favicon.svg
• OG 图片：社交分享图 /images/og.webp 不存在，改为 defaultone-logo.svg

🚀 国内访问优化

考虑到博客面向国内用户，对外部 CDN 资源做了镜像替换：

🎨 预加载器优化

首页预加载器（Preloader）原本使用纯白背景（z-index: 1100），配合 window.load + 5秒延迟隐藏。如果 Google Fonts 等海外资源被屏蔽，load 事件可能长时间不触发，导致预加载器一直遮挡页面。

改造后：

• 背景从纯白改为半透明毛玻璃效果（浅色 25% 透明度 + 12px 模糊）
• 深色模式同步适配
• 文字加载动画保留
• 预加载器隐藏后背景图直接透出

📝 内容更新

新增文章

• Hello World —— 程序员的起点：替换了原来与 study.md 重复的 Hexo 默认模板内容
• 学习笔记：重写为编程学习方法论

修正内容

• 日记文章中关于”购买域名”、”配置 Nginx”、”SSL 证书”等不实内容已删除
• 博客地址从错误的占位域名改为实际部署地址
• 关于页面身份从”小风”虚拟助手改为博主真实介绍

补充分类

所有文章补充了 tags 和 categories 元数据，方便内容归档和组织。

🗑️ 文件清理

• 创建 .gitignore，排除 node_modules/、public/、db.json 等
• 从 Git 仓库移除 yarn.lock（与 package-lock.json 冲突）
• 删除空的 _config.landscape.yml（历史遗留）
• 删除含敏感信息的文档文件

📄 文档更新

• README.md / README_zh-CN.md：重写为实际项目信息，删除错误的 Yarn/配置路径
• DEPLOYMENT.md：更新部署方式为 Gitee Pages，修正评论状态

📊 问题修复统计

💡 经验教训

1. 修改配置前先确认实际部署方式：不同的部署环境（Gitee Pages vs 自定义域名）需要不同的 URL 配置
2. 国内环境要测试海外资源加载：Google Fonts、jsdelivr、unpkg 在国内可能被屏蔽或限速，使用国内镜像更可靠
3. 预加载器要处理异常情况：依赖 window.load 触发隐藏的设计，在网络异常时可能导致页面卡住
4. 每次修改后先验证再提交：避免累积多个问题后难以定位

本文由AI辅助生成，内容仅供参考