dede:arclist 是 DedeCMS 最核心、最常用的列表标签,用于在首页、列表页等地方调用文章列表,输出文章地址主要通过 arcurl 这个底层字段来实现。

最基本和常用的方法:[field:arcurl/]
这是输出文章地址最直接、最常用的方法。
标签结构
{dede:arclist row='10' titlelen='30'}
<li>
<a href="[field:arcurl/]">[field:title/]</a>
</li>
{/dede:arclist}
参数解析
{dede:arclist ...}:arclist标签的开始。row='10': 表示调用 10 条文章记录,len='30'`: 表示文章标题最多显示 30 个字符(一个汉字算2个字符)。[field:arcurl/]: 这是底层字段,它的作用就是获取当前循环到的这条文章的完整访问地址。[field:title/]: 同样是底层字段,获取文章标题。</a>和</li>: HTML 标签,用于构建链接列表。
实际效果

当模板被解析后,[field:arcurl/] 会被替换成类似这样的真实地址:
https://www.yourdomain.com/a/2025/12345.html
或者
https://www.yourdomain.com/plus/view.php?aid=12345
这取决于你的网站在后台设置的“文章命名规则”。
深入理解 arcurl 的工作原理
[field:arcurl/] 输出的地址是由 DedeCMS 的系统配置决定的,你可以通过以下路径查看和修改:
- 登录 DedeCMS 后台。
- 进入 “系统” -> “系统基本参数” -> “核心设置”。
- 找到 “文章命名规则” 和 “列表命名规则” 这两个选项。
常见的文章命名规则(对 arcurl 的影响):
-
{typedir}/{Y}/{M}{D}/{aid}.html- 这是最推荐、对 SEO 最友好的规则。
- 生成的地址:
https://www.yourdomain.com/分类目录/年/月日/文章ID.html https://www.yourdomain.com/news/2025/10/15/12345.html- 特点:静态化、路径清晰、利于搜索引擎收录。
-
{typedir}/{aid}.html- 生成的地址:
https://www.yourdomain.com/分类目录/文章ID.html https://www.yourdomain.com/news/12345.html- 特点:静态化、路径较短。
- 生成的地址:
-
{typedir}/plus/view.php?aid={aid}- 生成的地址:
https://www.yourdomain.com/分类目录/plus/view.php?aid=12345 - 特点:动态地址,如果网站没有开启“伪静态”或“生成HTML”,文章地址就会是这样。
- 生成的地址:
你最终看到的 [field:arcurl/] 的输出结果,完全取决于后台“核心设置”里你填写的“文章命名规则”。
高级用法与注意事项
结合其他底层字段
[field:arcurl/] 通常会和其他底层字段一起使用,构建一个完整的文章列表项。
示例:显示标题、发布时间和摘要
{dede:arclist row='5' titlelen='40' infolen='100'}
<article class="excerpt">
<h2><a href="[field:arcurl/]" title="[field:title/]">[field:title/]</a></h2>
<p class="meta">发布于:[field:pubdate function="MyDate('Y-m-d',@me)"/]</p>
<p class="summary">[field:info/]...</p>
</article>
{/dede:arclist}
[field:pubdate function="MyDate('Y-m-d',@me)"/]: 调用发布时间,并通过function修饰符将其格式化为年-月-日的格式。[field:info/]: 获取文章摘要。
自定义链接文字
链接的文字通常是文章标题,但你也可以自定义。
{dede:arclist row='3'}
<a href="[field:arcurl/]" target="_blank">点击阅读全文</a>
{/dede:arclist}
上面的代码会给每篇文章都加上一个文字为“点击阅读全文”的链接。
在不同栏目下调用
{dede:arclist} 可以指定在哪个栏目下调用文章,arcurl 会自动指向对应栏目下的文章地址。
<!-- 只在 "新闻" 栏目(ID=1)下调用5篇文章 -->
{dede:arclist typeid='1' row='5'}
<a href="[field:arcurl/]">[field:title/]</a>
{/dede:arclist}
重要注意事项:{dede:list} 与 {dede:arclist} 的区别
新手很容易混淆这两个标签,它们输出的地址机制不同。
| 特性 | {dede:arclist} (文章列表) |
{dede:list} (列表页) |
|---|---|---|
| 使用位置 | 首页、封面页、其他文章页 | 列表模板 (list_*.htm) |
| 输出地址 | [field:arcurl/] 指向页 (如 html) |
[field:arcurl/] 指向下一页列表 (如 list_2.html) |
| 工作方式 | 调用文章数据,生成指向内容页的链接。 | 遍历当前栏目的分页,生成分页列表的链接。 |
- 在首页用
{dede:arclist},[field:arcurl/]是“点进去看文章”的链接。 - 在列表页(模板文件为
list_xxx.htm)用{dede:list},[field:arcurl/]是“看下一页文章列表”的链接。
如果你在列表页模板里错误地使用了 {dede:arclist},[field:arcurl/] 会正确地指向每一篇文章的内容页,而不是列表分页,如果你在首页错误地使用了 {dede:list},它可能无法正常工作,因为首页没有列表分页的概念。
要输出 DedeCMS 文章的地址,请遵循以下步骤:
- 使用标签:在
{dede:arclist}循环内部。 - 使用字段:调用底层字段
[field:arcurl/]。 - 构建链接:将其放在
<a>标签的href属性中,如<a href="[field:arcurl/]">。 - 后台配置:最终生成的地址格式由后台“系统基本参数 -> 核心设置 -> 文章命名规则”决定。
{dede:arclist} 和 {dede:list} 的区别,这是模板制作中的一个关键点。
