Jekyll博客文章文件名问题：部分文章无法显示求助

针对你遇到的问题，按以下顺序排查：

1. 确认文件存放路径
   确保无法显示的文章放在Jekyll默认的_posts目录下，路径层级和能正常显示的2023-01-28-design test.md完全一致，没有误放到其他文件夹（比如_drafts或自定义非文章目录）。

2. 检查文件名规范细节

   • 确认文件名开头的日期2023-02-01格式为YYYY-MM-DD且是有效日期；
   • 文件名中的连字符（-）必须是英文半角符号，避免使用中文全角符号；
   • 建议统一用连字符分隔单词，减少不同环境下的兼容性问题。

3. 验证Front Matter语法
   对比两篇文章的Front Matter，注意以下点：

   • 你能正常显示的文章存在语法错误：正文的# Introduction写在了结束标记---之前，属于Front Matter内的无效内容，Jekyll可能做了容错处理；
   • 检查无法显示的文章：确保categories、tags等列表项的缩进一致（用2个或4个空格，不要混合），键名（比如last_modified_at）拼写正确，无多余空格或符号。

4. 查看Jekyll构建日志
   在终端运行jekyll serve或jekyll build，仔细观察日志：

   • 若出现Liquid Exception、Invalid date等错误提示，直接根据提示修复；
   • 确认日志中出现无法显示的文章文件名，说明Jekyll已检测到该文件。

5. 清理缓存并重新构建
   运行以下命令清理缓存，避免缓存导致的内容不更新：

   jekyll clean
   jekyll serve
   

6. 强制设置发布状态
   在无法显示的文章Front Matter中添加published: true，强制标记为已发布：

   ---
   title: "how to use color"
   last_modified_at: 2023-02-01
   categories:
     - Blog
   tags:
     - design
     - color
   classes: wide
   published: true
   ---
   

内容的提问来源于stack exchange，提问作者Aeonify