静态站点修改记录

背景

老版本（20260209）Nuxt 打包的静态网站部署到 GitHub Pages 时，因 Jekyll 默认过滤下划线开头的文件/目录，导致 CSS、JS、图片等资源 404。

修改内容

1. 禁用 Jekyll 处理

• 新增 .nojekyll（空文件）
• 作用：让 GitHub Pages 直接按静态文件托管，不再忽略以下划线开头的资源

2. 目录重命名

原名	新名
_nuxt/	nuxt/
_ipx/	ipx/

3. 文件重命名

原名	新名	数量
_payload.json	payload.json	46 个
_product_.DR5_1h3L.css	product_.DR5_1h3L.css	1 个

4. 路径引用全局替换

所有 HTML、JS、CSS、JSON 文件中的以下路径已同步更新：

• /_nuxt/ → /nuxt/
• /_ipx/ → /ipx/
• _payload.json → payload.json
• _product_.DR5_1h3L.css → product_.DR5_1h3L.css

特别说明：Nuxt 部分 JS 文件（如 nuxt/C85TyJ_I.js、nuxt/DDA8OuP9.js）存在硬编码路径，已手动修正。

5. CSS 提取与合并

• 将各 index.html 中重复的内联 CSS（含 5 个 <style> 标签，约 640 KB/页）提取合并到外部文件
• 新增 nuxt/vuetify-styles.css（750 KB），包含：
  • Vuetify 工具类（间距、颜色、布局、网格等）
  • 7462 个 Material Design Icons 图标定义（@font-face + .mdi-*:before）
  • 全部组件样式（VBtn、VCard、VList、VTextField、VAlert 等 13 个 CSS 文件）
• 字体路径修正：仅保留 woff2 格式，/_nuxt/ → /nuxt/
• 效果：单页体积从约 700 KB 降至约 63 KB，47 个页面总计减少约 30 MB 重复代码

6. 调试代码清理

• 移除 nuxt/CNCMFOQ6.js 中的 console.log(e.product) 调试输出

7. 200.html / 404.html 优化

• 移除内联 CSS，改用外部引用 nuxt/vuetify-styles.css
• 单文件体积从 630 KB 降至 3.1 KB

优化工具

本项目全部优化工作均使用 TRAE IDE 辅助完成，包括：

• 目录/文件重命名及路径引用全局替换
• 内联 CSS 提取、合并与外部引用
• 图标字体路径修正与样式恢复
• 调试代码定位与清理
• 200.html / 404.html 体积优化
• 项目完整性审核（下划线路径、console.log、内联样式、图标定义等）

保留项

• .nojekyll 建议长期保留，作为防御性措施防止未来再次出现下划线文件被过滤的问题