WordPress 短代码是一段放在方括号中的简短指令，可以在文章或页面中插入图库、音视频、表单和动态内容。常见形式如下（需清除前后空格）：
[ gallery ]
短代码本身并不包含完整功能。WordPress 读取页面时，会找到负责处理这条指令的核心程序、插件或主题代码，再把短代码替换成真正的页面内容。
这也解释了为什么短代码有时可以正常显示，有时却只剩下一行原始文字。提供短代码的插件被停用、添加位置不支持解析，或者主题缺少对应处理逻辑，都会导致短代码失效。
WordPress短代码如何工作
保存文章时，WordPress 存储的是短代码指令，并不会提前保存最终输出。每次有人打开页面，WordPress 都会扫描正文，识别其中的短代码并执行对应处理函数。
因此，短代码可能出现以下情况。
- 插件停用后显示为原始文字
- 编辑器中看似正常，发布后却无法显示
- 在文章中可用，放到侧边栏后失效
- 更换主题后样式或输出位置发生变化
- 网站迁移后因缺少原插件而停止工作
短代码通常分为自闭合和成对两种形式。自闭合短代码可以单独使用。
[ gallery ]
成对短代码会包裹一段内容。
[notice]这里是提示内容[/notice]
具体写法由 WordPress 核心、插件或主题决定，使用前应查看相应功能的说明文档。
WordPress自带哪些短代码
WordPress 核心提供了一些基础媒体短代码，不安装插件也可以使用。
图库短代码
图库短代码用于显示媒体库中的多张图片。
[ gallery ]
也可以指定图片 ID。
[ gallery ids=”12,15,18″ ]
图库的列数、间距和响应式效果会受到主题样式影响。同一段短代码放在不同主题中，最终外观可能不同。
音频和视频短代码
音频短代码可以为媒体文件生成播放器。
[ audio src=”song.mp3″ ]
视频短代码的写法如下。
[ video src=”demo.mp4″ ]
如果文件地址错误，或者浏览器不支持对应格式，播放器可能无法正常显示。
播放列表短代码
需要在同一个播放器中展示多个音频文件时，可以使用播放列表。
[ playlist type=”audio” ids=”12,13,14″ ]
这种方式适合播客、多段录音和音乐内容。
嵌入与图片说明
WordPress 还能处理媒体嵌入和图片说明。不过在现代 WordPress 中，YouTube、图片说明和大多数媒体内容通常更适合使用对应区块，编辑时能够直接看到预览效果。
如何在文章和页面中添加短代码
文章和页面是使用短代码最稳定的位置。
在区块编辑器中打开文章，将光标放到目标位置，点击添加区块并搜索“短代码”，随后粘贴完整指令。
[ contact-form ]
也可以把短代码直接放入合适的文本区域，但专用短代码区块更容易识别，也能减少自动格式化带来的问题。
使用经典编辑器时，可以把短代码单独放在一行。发布或预览页面后，WordPress 会将其替换成相应功能。
如果页面显示原始代码，应先确认提供该短代码的插件是否已经安装并启用。
小工具和侧边栏能否使用短代码
这取决于主题和小工具类型。
部分主题会自动解析小工具中的短代码，另一些主题只会把它当作普通文字。如果同一条短代码在文章中正常，在侧边栏中却显示原文，通常说明该小工具区域没有启用短代码处理。
可以先尝试 WordPress 提供的短代码区块或主题支持的自定义内容区域。不要为了让侧边栏执行短代码，随意把来源不明的 PHP 代码加入主题文件。
如何在主题文件中执行短代码
主题模板默认不会像文章正文一样自动解析短代码。开发者可以通过 do_shortcode() 主动执行。
<?php echo do_shortcode( '[ my_shortcode ]' ); ?>
这种方法应谨慎使用。
把短代码直接写进主题文件，会让页面功能依赖当前主题和插件。更换主题、停用插件或更新模板后，功能可能消失。需要修改主题代码时，应优先使用子主题，并记录短代码来源与用途。
如果只是给文章添加表单、图库或动态列表，通常没有必要修改主题文件。
短代码失效怎么排查
短代码显示为原始文字或没有任何输出时，可以按以下顺序检查。
检查插件状态
确认提供短代码的插件仍在运行。插件停用或删除后，对应处理函数不再存在，WordPress 只能显示原始文字。
检查短代码拼写
短代码名称、属性、引号和结束标签都要完整。插件升级后如果修改了参数，也可能导致旧写法失效。
换到文章正文测试
把短代码放到一篇测试文章的短代码区块中。如果正文能够运行，侧边栏或自定义字段却不能运行，问题通常出在添加位置。
检查主题和构建器支持
部分页面构建器、自定义字段和页眉页脚工具不会自动执行短代码，需要使用专门的短代码组件。
查看错误日志
如果页面空白、出现 500 错误或短代码执行后中断，可以检查 PHP 错误日志，确认是否有插件函数报错。相关阅读：《WordPress错误日志是什么？如何启用和查看错误日志？》
短代码有哪些优点
短代码适合插入可重复使用的动态功能。
- 写法简短，添加速度快
- 可以在多个页面重复使用
- 不需要直接修改页面模板
- 适合表单、播放器和动态列表
- 能兼容大量旧版 WordPress 内容
- 在经典编辑器和许多构建器中仍可使用
对于没有提供区块的插件，短代码仍然是连接插件功能和页面内容的有效方式。
短代码有哪些限制
短代码也会增加网站依赖。
- 停用来源插件后可能显示原始代码
- 编辑过程中通常看不到完整预览
- 大量短代码会增加后期迁移难度
- 与单一主题绑定时容易造成内容锁定
- 动态查询复杂时可能影响页面速度
- 调试时需要了解插件和主题的加载方式
清理插件前，应先搜索网站中是否仍有对应短代码。否则插件删除后，历史文章可能留下大量无法执行的方括号文本。
短代码和Gutenberg区块怎么选
短代码更像一条功能指令，区块则是可以在编辑器中直接操作的可视化组件。
页面布局、图片、按钮、分栏和静态内容通常更适合使用区块。编辑时能够看到接近前台的效果，也方便调整间距、颜色和对齐方式。
表单、条件内容、动态查询和旧插件功能仍可能更适合短代码，尤其是在插件没有提供区块版本时。
可以使用一个简单的判断方法。
- 功能主要依赖动态逻辑时，可以考虑短代码
- 内容主要依赖视觉布局时，优先使用区块
- 插件同时提供区块和短代码时，通常先尝试区块
- 维护旧内容或需要兼容经典编辑器时，可以保留短代码
两者也可以配合使用。页面整体结构由 Gutenberg 区块完成，某个区块内部再通过短代码插入表单或动态列表。
常见问题
WordPress短代码在哪里找
插件通常会在设置页面、功能创建页面或官方文档中提供短代码。创建表单、图库或其他内容后，后台也可能直接显示可复制的代码。
如何让短代码显示为普通文字
可以使用双层方括号。
[[ my_shortcode ]]
WordPress 会显示短代码文字，而不执行对应功能。
为什么短代码在文章中有效，在页脚中却无效
文章正文会主动解析短代码，某些页脚、小工具和自定义字段不会。应使用主题提供的短代码组件，或由开发者在合适位置加入解析逻辑。
短代码会影响网站速度吗
短代码会在页面加载时执行。简单输出影响通常有限，复杂数据库查询、远程请求或一次调用大量短代码，则可能增加响应时间。性能取决于处理函数，而不只是短代码数量。
可以自己创建WordPress短代码吗
可以。开发者可以编写返回内容的 PHP 函数，再通过 add_shortcode() 注册。输出应使用 return，同时做好参数验证、权限检查和内容转义。
分类：新闻资讯
标签：wordpress