如何在Hugo中按FilePath优先排序内容，替代Weight前置参数？

嘿，我对Hugo的内容排序逻辑门儿清，你的需求完全不用搞复杂的自定义模板，直接用它原生的能力就能完美解决，还能避免重复维护排序信息的麻烦！

核心逻辑 #

你希望教程顺序和01_getting_started.md、02_setup.md这类文件命名完全匹配，并且让文件路径的优先级高于标题排序，刚好Hugo内置的ByFilePath排序方法就是干这个的——它会直接根据文件的完整路径（包括文件名）来排序，完全不用依赖前置参数里的Weight。

具体操作步骤 #

1. 先规范你的文件命名 #

按照教程的逻辑顺序给文件加数字前缀，确保数字越大对应教程越靠后。比如：

• 01_getting_started.md（入门篇）
• 02_environment_setup.md（环境搭建）
• 03_basic_serialization.md（基础序列化）
• 04_advanced_use_cases.md（进阶用法）
  这种命名方式让文件名本身就自带排序信息，Hugo能直接识别。

2. 修改列表模板的排序规则 #

找到你的教程列表模板（通常是layouts/_default/list.html，如果是单独的教程栏目，也可能是layouts/tutorial/list.html这类自定义模板），把内容遍历的代码改成按FilePath排序：

{{ range .Pages.ByFilePath }}
  <div class="tutorial-item">
    <a href="{{ .RelPermalink }}">{{ .Title }}</a>
    <p>{{ .Summary }}</p>
  </div>
{{ end }}

这里的ByFilePath会自动按照文件路径的字典序排序，而你的数字前缀刚好能让字典序和教程逻辑序完全一致，完美契合你的需求。

3. 验证效果 #

启动本地服务hugo server，打开教程列表页看看——内容肯定是按照你命名的数字顺序排列的，而且完全不用在每个文件的前置参数里写Weight，省了好多重复工作！

进阶小技巧 #

如果你的教程是分章节存放在子目录里的，比如：

• 01_introduction/01_what_is_serialization.md
• 01_introduction/02_why_use_it.md
• 02_core_concepts/01_basic_types.md
  只要子目录也用数字前缀命名，ByFilePath同样能正确识别整个路径的顺序，保持章节和小节的层级逻辑不乱。

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