# 第2步：JS按需加载优化 - 最终实施方案

## 📊 优化策略总结

### 核心原则
1. **UIkit始终加载** - 作为基础框架，不按需加载
2. **核心功能始终加载** - 导航、搜索、主题切换等
3. **页面特定功能按需加载** - 评论、打赏、无限滚动等
4. **延迟加载非关键功能** - Toast、懒加载等

---

## 🔧 实施代码

### 修改footer.html（第50-133行）

**删除原有代码，替换为：**

```gohtml
{{/* ====== 优化后的JS加载策略 ====== */}}

{{/* ====== 1. 核心JS Bundle - 始终加载 ====== */}}
{{ $iconfont := resources.Get "js/libs/iconfont.js" }}
{{ $uikit := resources.Get "js/libs/uikit.min.js" }}
{{ $viewimage := resources.Get "js/libs/view-image.min.js" }}
{{ $utils := resources.Get "js/modules/utils.js" }}
{{ $loader := resources.Get "js/modules/loader.js" }}
{{ $cache := resources.Get "js/modules/cache.js" }}
{{ $search := resources.Get "js/modules/search.js" }}
{{ $floatingTools := resources.Get "js/modules/floating-tools.js" }}
{{ $nprogress := resources.Get "js/libs/nprogress.js" }}
{{ $pjaxLib := resources.Get "js/libs/pjax.js" }}
{{ $mypjax := resources.Get "js/modules/mypjax.js" }}
{{ $pangu := resources.Get "js/modules/pangu.js" }}
{{ $linkify := resources.Get "js/modules/linkify.js" }}
{{ $main := resources.Get "js/main.js" }}

{{ $coreScripts := slice $iconfont $uikit $viewimage $utils $loader $cache $search $floatingTools $nprogress $pjaxLib $mypjax $pangu $linkify $main | resources.Concat "js/core.js" | resources.Minify | resources.Fingerprint }}

<script defer src="{{ $coreScripts.RelPermalink }}"></script>

{{/* ====== 2. 配置变量 - 必须在核心JS之前或同时 ====== */}}
<script>
  window.enableInfiniteScroll = {{ .Site.Params.infiniteScroll.enable | default false }};
</script>

{{/* ====== 3. 远程数据获取 - 构建时 ====== */}}
{{/* Fetch friend data at build time — no runtime network requests */}}
{{ $linkHosts := slice }}
{{ $linkNames := slice }}
{{ with resources.GetRemote "https://api.usj.cc/api/links?all=1" }}
  {{ with .Err }}
    {{ warnf "Links API fetch failed: %s" . }}
  {{ else }}
    {{ with .Content | transform.Unmarshal }}
      {{ range .links }}
        {{ $host := "" }}
        {{ with .url | urls.Parse }}
          {{ $host = .Host | strings.TrimPrefix "www." }}
        {{ end }}
        {{ $title := .name | default "" }}
        {{ if $host }}
          {{ $linkHosts = $linkHosts | append (dict "host" $host "title" $title) }}
        {{ end }}
        {{ if $title }}
          {{ $linkNames = $linkNames | append (dict "lower" (lower $title) "title" $title) }}
        {{ end }}
      {{ end }}
    {{ end }}
  {{ end }}
{{ end }}
<script>
  window.friendLinks = {{ dict "hosts" $linkHosts "names" $linkNames | jsonify | safeJS }};
</script>

{{ $feedHosts := slice }}
{{ $feedNames := slice }}
{{ with resources.GetRemote "https://api.usj.cc/api/feeds" }}
  {{ with .Err }}
    {{ warnf "Feeds API fetch failed: %s" . }}
  {{ else }}
    {{ with .Content | transform.Unmarshal }}
      {{ range .feeds }}
        {{ $host := "" }}
        {{ with .url | urls.Parse }}
          {{ $host = .Host | strings.TrimPrefix "www." }}
        {{ end }}
        {{ $title := .feedTitle | default "" }}
        {{ if $host }}
          {{ $feedHosts = $feedHosts | append (dict "host" $host "title" $title) }}
        {{ end }}
        {{ if $title }}
          {{ $feedNames = $feedNames | append (dict "lower" (lower $title) "title" $title) }}
        {{ end }}
      {{ end }}
    {{ end }}
  {{ end }}
{{ end }}
<script>
  window.friendFeeds = {{ dict "hosts" $feedHosts "names" $feedNames | jsonify | safeJS }};
</script>

{{/* ====== 4. 页面特定JS - 按需加载 ====== */}}

{{/* 文章详情页专用JS */}}
{{ if .IsPage }}
  {{ $artalkModule := resources.Get "js/modules/artalk.js" }}
  {{ $paragraphComments := resources.Get "js/modules/paragraph-comments.js" }}
  {{ $reward := resources.Get "js/modules/reward.js" }}
  
  {{ $pageScripts := slice $artalkModule $paragraphComments $reward | resources.Concat "js/page-only.js" | resources.Minify | resources.Fingerprint }}
  
  <script defer src="{{ $pageScripts.RelPermalink }}"></script>
{{ end }}

{{/* 首页专用JS */}}
{{ if .IsHome }}
  {{ if .Site.Params.infiniteScroll.enable }}
    {{ $infiniteScroll := resources.Get "js/modules/infinite-scroll.js" }}
    <script defer src="{{ $infiniteScroll.RelPermalink }}"></script>
  {{ end }}
{{ end }}

{{/* 特定页面专用JS */}}
{{ if or (eq .Type "links") (eq .Type "circles") }}
  {{ $tiaozhuan := resources.Get "js/modules/tiaozhuan.js" }}
  <script defer src="{{ $tiaozhuan.RelPermalink }}"></script>
{{ end }}

{{/* ====== 5. 延迟加载的非关键JS ====== */}}
{{ $toast := resources.Get "js/modules/toast.js" }}
{{ $easylazyload := resources.Get "js/modules/lazyload.js" }}

{{ $deferredScripts := slice $toast $easylazyload | resources.Concat "js/deferred.js" | resources.Minify | resources.Fingerprint }}

<script>
  // 使用requestIdleCallback在浏览器空闲时加载
  if ('requestIdleCallback' in window) {
    requestIdleCallback(function() {
      var script = document.createElement('script');
      script.src = '{{ $deferredScripts.RelPermalink }}';
      script.defer = true;
      document.body.appendChild(script);
    });
  } else {
    setTimeout(function() {
      var script = document.createElement('script');
      script.src = '{{ $deferredScripts.RelPermalink }}';
      script.defer = true;
      document.body.appendChild(script);
    }, 1000);
  }
</script>

{{/* ====== 6. 第三方脚本 ====== */}}
<script async src="/js/bsz.js"></script>
```

---

## 📦 Bundle拆分详情

### Core.js（核心bundle）
**包含：** ~14个文件
**大小：** ~200KB（压缩后）
**加载策略：** defer（DOM解析完成后立即执行）

**包含模块：**
- UIkit框架
- 图标字体
- 图片灯箱
- 工具函数
- 加载器
- 缓存
- 搜索
- 浮动工具
- 进度条
- PJAX
- 中英文空格处理
- 链接处理
- 主题主逻辑

### Page-only.js（文章详情页专用）
**包含：** 3个文件
**大小：** ~180KB（压缩后）
**加载策略：** defer（仅在文章详情页加载）

**包含模块：**
- Artalk评论系统
- 段落评论
- 打赏功能

### Deferred.js（延迟加载）
**包含：** 2个文件
**大小：** ~25KB（压缩后）
**加载策略：** requestIdleCallback（浏览器空闲时加载）

**包含模块：**
- Toast消息
- 图片懒加载

### 独立加载的JS
- infinite-scroll.js - 仅首页（如果启用）
- tiaozhuan.js - 仅links/circles页面
- bsz.js - 异步加载（不蒜子计数）

---

## 🎯 优化效果预估

### 首页加载
```
优化前：
HTML ████████░░░░░░░░░░
CSS  ██████░░░░░░░░░░░░ (内联)
JS   ██████████████████ (800KB，全部加载)
渲染 ████████████░░░░░░

优化后：
HTML ████████░░░░░░░░░░
CSS  ██████░░░░░░░░░░░░ (内联)
JS   ██████████░░░░░░░░ (350KB，核心+条件)
空闲 ░░░░░░░░░░████░░░░ (25KB，延迟加载)
渲染 ████████████████░░ (提前！)
```

### 文章详情页加载
```
优化前：
JS   ██████████████████ (800KB)
渲染 ████████████░░░░░░

优化后：
JS   ████████████░░░░░░ (450KB)
渲染 ████████████████░░ (提前！)
评论 ░░░░░░░░░░████████ (Artalk按需加载)
```

---

## 🧪 功能测试清单

### 必测项目

#### 1. 首页功能
- [ ] 导航菜单点击正常
- [ ] 搜索框打开/关闭正常
- [ ] 搜索结果显示正常
- [ ] 主题切换（深色/浅色）正常
- [ ] 文章列表正常显示
- [ ] 无限滚动加载正常（如果启用）
- [ ] 浮动工具栏正常（搜索、主题、返回顶部）

#### 2. 文章详情页功能
- [ ] 文章内容正常显示
- [ ] 图片灯箱正常（点击查看大图）
- [ ] Artalk评论区正常加载
- [ ] 评论功能正常（发布、回复）
- [ ] 打赏按钮功能正常
- [ ] 段落评论功能正常（如果启用）
- [ ] 返回顶部按钮正常

#### 3. 其他页面功能
- [ ] 友链页面跳转正常
- [ ] circles页面功能正常
- [ ] 归档页面正常
- [ ] 搜索结果页正常

#### 4. 跨页面功能
- [ ] PJAX导航正常（页面无刷新切换）
- [ ] 浏览器前进/后退正常
- [ ] 书签/分享链接正常

### 性能测试

#### Chrome DevTools测试

**Network面板：**
1. 打开DevTools → Network
2. 刷新页面
3. 检查：
   - [ ] core.js首先加载
   - [ ] page-only.js仅在文章页加载
   - [ ] deferred.js最后加载
   - [ ] 总体JS大小减少

**Performance面板：**
1. 记录页面加载
2. 检查：
   - [ ] TBT（Total Blocking Time）减少
   - [ ] 长任务数量减少
   - [ ] 交互响应更快

**Lighthouse：**
1. 运行Performance审计
2. 预期指标：
   - [ ] Performance得分：90+
   - [ ] TTI：改善20-30%
   - [ ] TBT：改善40-50%
   - [ ] Speed Index：改善20-30%

---

## 🐛 故障排除

### 问题1：评论区未加载

**症状：** 文章详情页看不到评论区

**可能原因：**
1. page-only.js加载失败
2. Artalk初始化时机不对
3. JavaScript错误

**解决方案：**
1. 打开Console查看错误
2. 检查Network面板，确认page-only.js加载成功
3. 确认artalkConfig存在（head.html中定义）

### 问题2：功能延迟初始化

**症状：** 点击某些按钮无响应，过一会儿才正常

**原因：** 模块还未加载完成就尝试调用

**解决方案：**
- 这是预期行为，用户可能会感觉到轻微延迟
- 如果延迟明显，考虑将该模块移到core.js中

### 问题3：无限滚动失效

**症状：** 首页无法加载更多文章

**可能原因：**
1. infinite-scroll.js未加载
2. window.enableInfiniteScroll未定义

**解决方案：**
1. 确认Site.Params.infiniteScroll.enable为true
2. 检查Console是否有错误
3. 确认infinite-scroll.js加载成功

---

## 🔄 回滚方案

如果优化后出现严重问题，快速回滚：

```gohtml
{{/* 恢复原始JS加载方式 */}}
{{ $iconfont := resources.Get "js/libs/iconfont.js" }}
{{ $uikit := resources.Get "js/libs/uikit.min.js" }}
{{ $easylazyload := resources.Get "js/modules/lazyload.js" }}
{{ $viewimage := resources.Get "js/libs/view-image.min.js" }}
{{ $main := resources.Get "js/main.js" }}
{{ $mypjax := resources.Get "js/modules/mypjax.js" }}
{{ $nprogress := resources.Get "js/libs/nprogress.js" }}
{{ $tiaozhuan := resources.Get "js/modules/tiaozhuan.js" }}
{{ $toast := resources.Get "js/modules/toast.js" }}
{{ $reward := resources.Get "js/modules/reward.js" }}
{{/* Modules */}}
{{ $utils := resources.Get "js/modules/utils.js" }}
{{ $loader := resources.Get "js/modules/loader.js" }}
{{ $cache := resources.Get "js/modules/cache.js" }}
{{ $search := resources.Get "js/modules/search.js" }}
{{ $floatingTools := resources.Get "js/modules/floating-tools.js" }}
{{ $paragraphComments := resources.Get "js/modules/paragraph-comments.js" }}
{{ $infiniteScroll := resources.Get "js/modules/infinite-scroll.js" }}
{{ $artalkModule := resources.Get "js/modules/artalk.js" }}
{{ $pjaxLib := resources.Get "js/libs/pjax.js" }}
{{ $linkify := resources.Get "js/modules/linkify.js" }}
{{ $pangu := resources.Get "js/modules/pangu.js" }}

{{ $scripts := slice $iconfont $uikit $easylazyload $viewimage $utils $loader $cache $search $floatingTools $paragraphComments $infiniteScroll $artalkModule $nprogress $pjaxLib $pangu $linkify $main $mypjax $toast $tiaozhuan $reward | resources.Concat "js/bundle.js" | resources.Minify | resources.Fingerprint }}

<script defer src="{{ $scripts.RelPermalink }}"></script>
<script async src="/js/bsz.js"></script>
```

---

## ✅ 完成确认

测试通过后，第2步即完成。继续第3步：**字体子集化优化**

---

**文档版本：** v2.0
**最后更新：** 2026-06-03