✨ 点击图片换一张(老婆/猫/狗/二次元) ✨
加载中...
.nojekyll 文件
在GitHub Pages的根目录下放一个空的 .nojekyll 文件,核心作用就是告诉GitHub:“不要用Jekyll处理我的网站,直接把我上传的文件原样发布。”
GitHub Pages默认会开启Jekyll这个静态网站生成器。这对于用Markdown写博客的人来说很方便,但对于你这种已经自己写好了index.html、post.html,并且文章数据存在posts.json里的情况,Jekyll的自动处理反而会帮倒忙。
具体来说,.nojekyll可以帮你避开两个最实际的问题:
- 防止文件被“忽略”:Jekyll有个规则,会忽略所有以下划线 _ 开头的文件和文件夹。这本来是为了过滤掉它自己的配置文件。但你的项目里如果有以 _ 开头的文件(比如 _posts 文件夹),就会被Jekyll忽略,导致上传后无法访问。加上.nojekyll后,所有文件都会原封不动地保留。
- 避免构建报错:如果Jekyll在你的项目里遇到它不认识或处理不了的文件,构建过程可能会失败,导致网站无法更新。放上.nojekyll后,GitHub会跳过处理步骤,直接展示你的文件。
📅 最后更新:2026-04-18 00:00