Giscus本地正常但Vercel生产环境无法加载（Chirpy+Jekyll）

根据你描述的现象（本地正常渲染Giscus评论，Vercel生产环境缺失脚本标签），核心问题出在Vercel构建过程中的配置加载或主题渲染逻辑差异，以下是具体排查方向和解决方法：

1. 检查生产环境配置文件覆盖 #

Jekyll在production环境下会自动加载_config.production.yml（如果存在），该文件的配置会覆盖基础的_config.yml：

• 确认仓库中是否存在_config.production.yml；
• 如果存在，检查其中是否包含完整的Giscus配置，若未配置则补充：

  comments:
    provider: giscus
    giscus:
      repo: w-dib/w-dib.github.io
      repo_id: R_kgDONaq1kA
      category: Announcements
      category_id: DIC_kwDONaq1kM4Clp6n
      mapping: pathname
      strict: 0
      input_position: bottom
      lang: en
      reaction_enabled: 1
  

• 若该文件中comments.provider被设为其他值，修改为giscus。

2. 修正Vercel构建命令 #

Vercel默认的Jekyll构建命令会优先加载生产环境配置文件，若你希望强制使用基础配置，可修改构建命令：

1. 进入Vercel项目的「Settings」→「Build & Development Settings」；
2. 将「Build Command」修改为：

   jekyll build --config _config.yml
   

3. 重新部署项目。

3. 验证主题评论渲染条件 #

Chirpy主题的评论模块可能存在条件渲染逻辑：

• 检查文章的Front Matter，确认是否添加了comments: true（部分主题默认需要显式开启单篇文章的评论功能）；
• 查看主题的_includes/comments.html或_includes/comments-providers/giscus.html文件，确认其中的条件判断（如site.comments.provider == 'giscus'、page.comments是否为true）在生产环境下均能满足。

4. 清除Vercel构建缓存 #

旧的构建缓存可能导致配置未更新：

• 进入Vercel项目的「Deployments」页面；
• 找到最新的部署记录，点击「Redeploy」并勾选「Clear Build Cache」选项，重新构建部署。

内容的提问来源于stack exchange，提问作者Walid Daniel Dib