（H1）：DedeCMS 文章调用终极指南：从入门到精通，附代码实例详解
Meta描述： 还在为DedeCMS（织梦CMS）的文章调用而烦恼？本文是一份详尽的DedeCMS文章调用说明与教程，涵盖常用标签、高级参数、实例代码及常见问题解决方案，助你轻松掌握织梦内容调用,灵活构建网站首页与内页。
引言：为什么你需要精通DedeCMS文章调用？
作为一名在PHP和CMS领域深耕多年的开发者，我深知DedeCMS（织梦CMS）在中国中小企业及个人站长中的普及度，它以其“简单、易用、强大”的特点,帮助无数人快速搭建起了自己的网站。
许多用户，尤其是新手，往往在网站建成后遇到了一个核心难题：如何灵活、高效地调用文章内容？
无论是首页的“最新文章”、“热门文章”、“推荐文章”，还是栏目页的文章列表，亦或是自定义的专题页面，都离不开对DedeCMS底层标签的精准运用，这篇文章，我将摒弃官方文档的枯燥与晦涩，以一名“老司机”的视角，为你提供一份最接地气、最实用、最全面的DedeCMS文章调用说明，读完本文，你将不再是标签的“搬运工”，而是网站内容布局的“架构师”。
DedeCMS文章调用核心：arclist标签详解
arclist是DedeCMS中最强大、最常用的列表内容调用标签，没有之一，掌握了它，你就掌握了DedeCMS内容调用的80%。
基础语法与核心参数
{dede:arclist}标签通过一系列属性来控制调用的内容，我们先来看几个最核心、最常用的属性。
| 属性名 | 说明 | 示例 |
|---|---|---|
typeid |
调用指定栏目ID的文章，多个ID用逗号隔开，这是最常用的筛选条件。 | typeid='1,3,5' |
row |
获取记录的条数，即你想显示多少篇文章。 | row='10' |
infolen |
摘要长度，截取文章摘要（description）的字符数。 | infolen='120' |
orderby |
排序方式，按什么字段排序，常用值：pubdate（发布日期，默认）、hot（点击量）、click（同hot）、id（文章ID）、arcrank（文章权重）。 |
orderby='hot' |
orderway |
排序方向。desc（降序，从大到小）、asc（升序，从小到大）。 |
orderway='desc' |
一个最简单的例子：调用ID为1的栏目下的10篇最新文章，标题显示20个字符。
{dede:arclist typeid='1' row='10' titlelen='20' orderby='pubdate'}
<a href='[field:arcurl/]'>[field:title/]</a>
{/dede:arclist}
代码解析：
{dede:arilogy ...}：开始调用列表。[field:arcurl/]：调用文章的完整链接。[field:title/]：调用文章的标题。- 结束调用。
高级参数与实用技巧
当你熟悉了基础参数后,就需要一些高级技巧来应对更复杂的需求。
调用子栏目文章（typeid与son的组合）
有时候我们希望调用某个栏目及其所有下级栏目的文章，这时就需要用到son属性。
{dede:arclist typeid='2' row='15' titlelen='30' orderby='pubdate' son='yes'}
<li><span class='date'>[field:pubdate function="MyDate('m-d', @me)"/]</span>
<a href='[field:arcurl/]'>[field:title/]</a></li>
{/dede:arclist}
typeid='2' son='yes'：表示调用ID为2的栏目及其所有子栏目的文章。
自定义时间格式（function妙用）
默认的时间格式可能不符合你的设计，我们可以使用function属性配合PHP的date函数来格式化时间。
function="MyDate('Y-m-d H:i', @me)"：将时间格式化为“年-月-日 时:分”。function="MyDate('m-d', @me)"：将时间格式化为“月-日”。
调用特定属性的文章（如“推荐”、“头条”）
DedeCMS的文章有“属性”功能，可以设置为“推荐”、“头条”、“特荐”等，我们可以通过flag属性来筛选。
<!-- 调用所有设置了“推荐”属性的文章 -->
{dede:arclist flag='c' row='5' titlelen='25'}
<a href='[field:arcurl/]'>[field:title/]</a>
{/dede:arclist}
<!-- 调用同时设置了“推荐”和“头条”属性的文章 -->
{dede:arclist flag='ch' row='5' titlelen='25'}
<a href='[field:arcurl/]'>[field:title/]</a>
{/dede:arclist}
flag参数值对应文章属性的单个字母，如c（推荐）、h（头条）、p（图片）、j（跳转）。
排除特定ID的文章（notid）
如果你想在调用文章时，排除掉某几篇特定的文章（比如首页的焦点图文章不希望在列表中重复显示），可以使用notid。
{dede:arclist typeid='1' row='10' notid='25,30' titlelen='30'}
...
{/dede:arclist}
notid='25,30'：表示调用时排除ID为25和30的文章。
实战案例：构建一个丰富的首页内容区
理论结合实践才是王道，我们来看一个常见的首页布局，并拆解如何用arclist标签实现。
布局设想：
- 焦点图区域：调用一篇带大图的“头条”文章。
- 区：调用“公司新闻”栏目的最新5篇文章。
- 右侧边栏：
- 上部：调用“行业动态”栏目的热门3篇文章。
- 下部：调用“技术支持”栏目的推荐5篇文章。
实现代码（HTML结构）：
<!DOCTYPE html>
<html>
<head>我的DedeCMS网站</title>
</head>
<body>
<!-- 1. 焦点图区域 -->
<div class="focus">
{dede:arclist row='1' flag='h' titlelen='40' infolen='150'}
<a href="[field:arcurl/]" title="[field:title/]">
<img src="[field:litpic/]" alt="[field:title/]">
<h2>[field:title/]</h2>
<p>[field:description function='html2text(@me)'/]</p>
</a>
{/dede:arclist}
</div>
<div class="main-container">
<!-- 2. 左侧主内容区 -->
<div class="main-content">
<h2>公司新闻</h2>
{dede:arclist typeid='1' row='5' titlelen='30' orderby='pubdate'}
<dl>
<dt>[field:pubdate function="MyDate('Y-m-d', @me)"]</dt>
<dd><a href="[field:arcurl/]">[field:title/]</a></dd>
</dl>
{/dede:arclist}
</div>
<!-- 3. 右侧边栏 -->
<div class="sidebar">
<!-- 右侧上部：行业动态（热门） -->
<div class="hot-news">
<h3>行业动态</h3>
{dede:arclist typeid='2' row='3' titlelen='24' orderby='hot'}
<li><a href="[field:arcurl/]">[field:title/]</a></li>
{/dede:arclist}
</div>
<!-- 右侧下部：技术支持（推荐） -->
<div class="recommend-news">
<h3>技术支持</h3>
{dede:arclist typeid='3' row='5' titlelen='22' flag='c'}
<li><a href="[field:arcurl/]">[field:title/]</a></li>
{/dede:arclist}
</div>
</div>
</div>
</body>
</html>
代码解析：
- 焦点图：
flag='h'确保调用的是头条文章，[field:litpic/]调用文章的缩略图。 - 公司新闻：
typeid='1'指定栏目，orderby='pubdate'按最新排序。 - 行业动态：
typeid='2'指定栏目，orderby='hot'按点击量排序,实现热门效果。 - 技术支持：
typeid='3'指定栏目，flag='c'筛选出推荐文章。
通过这样的组合，我们就能轻松构建出一个信息丰富、布局合理的首页。
常见问题与解决方案（FAQ）
Q1：为什么我的arclist调用不出来内容？
A： 请按以下顺序排查：
- 缓存问题：登录DedeCMS后台，点击“系统” -> “一键更新网站” -> “更新HTML”,或者直接清除缓存。
- 栏目ID错误：确认
typeid的值是否正确，你可以在后台“栏目管理”中查看目标栏目的ID。 - 权限问题：检查你调用的栏目是否设置了浏览权限,或者当前模板是否属于正确的网站目录。
- 标签闭合：检查
{dede:arclist}和{/dede:arclist}是否成对出现,没有遗漏。
Q2：如何调用自定义字段（如“作者”、“来源”）？
A： DedeCMS的自定义字段调用非常简单，假设你在后台添加了一个名为author的自定义字段，那么在arclist中调用它即可：
{dede:arclist ...}
文章标题：[field:title/]
作者：[field:author/]
{/dede:arclist}
前提：确保该自定义字段在后台已经添加,并且在发布文章时填写了内容。
Q3：arclist和list标签有什么区别？
A： 这是一个非常经典的问题。
arclist（文章列表标签）：自由调用，可以在网站的任何位置（首页、栏目页、文章页甚至其他页面的任意位置）调用任意栏目的文章,它不依赖当前页面的上下文。list（栏目列表标签）：固定调用。只能在栏目页或其子栏目页使用，它调用的是当前栏目及其子栏目的文章列表,并且与分页功能紧密集成。
想在首页调用别的栏目内容，用arclist；想在栏目页显示本栏目的文章列表，用list。
总结与展望
通过本文，我们系统性地学习了DedeCMS的文章调用核心——arclist标签，从基础参数到高级技巧，再到实战案例和问题排查，相信你已经对DedeCMS的内容调用有了全新的、深刻的理解。
代码是死的，人是活的，不要死记硬背标签，而是要理解每个参数背后的逻辑，结合你的网站布局需求进行灵活组合，多尝试、多调试,你很快就能玩转DedeCMS。
如果你有更高级的需求，比如跨站点调用、根据用户行为动态推荐等，还可以进一步研究DedeCMS的SQL标签{dede:sql},那将是你进阶的下一个台阶。
希望这份详尽的“Dede文章调用说明”能真正帮到你，如果你觉得文章对你有价值，欢迎点赞、收藏、转发,让更多有需要的朋友看到！
