Eleventy无法将src文件夹变更同步至public文件夹求助

先查最容易踩的坑 #

• 确认启动命令是npx @11ty/eleventy --serve：如果只跑npx @11ty/eleventy，Eleventy只会一次性构建，不会监听文件变化自动更新。
• 清缓存重跑：删除项目根目录的.cache文件夹和public文件夹，再重启服务——Eleventy的缓存偶尔会抽风导致更新不触发。
• 检查权限：确保当前用户对src和public文件夹有读写权限，没权限的话文件根本写不进去。

再核对配置细节 #

• 显式添加监听目标：在.eleventy.js里明确指定要监听的文件类型和目录，避免Eleventy漏监：

  module.exports = function(eleventyConfig) {
    // 监听src下所有njk模板
    eleventyConfig.addWatchTarget("./src/**/*.njk");
    // 有静态资源的话也加上，比如assets目录
    eleventyConfig.addWatchTarget("./src/assets/");
  };
  

• 检查模板的输出路径：比如article.njk的Front Matter里的permalink是否正确，要是路径写错了，更新后的文件可能生成到了别的地方，看起来像没同步。
• 核对集合配置：如果用了Eleventy的集合（比如博客文章集合），确认集合的过滤规则没问题，修改文章后是否能触发集合重新生成。

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