vs code 默认不识别 smarty 语法，需安装 vscode-smarty 插件并手动关联 .tpl 文件到 smarty 模式；{php}...{/php} 块内 php 功能需配合 intelephense 启用嵌入语言支持，但仍有局限，推荐将逻辑移出模板。
VS Code 默认不识别 Smarty 模板语法，.tpl 文件会以纯文本或 HTML 模式打开，导致 PHP 变量（如 {$name}）、函数（如 {php}...{/php}）和标签（如 {foreach from=$list item=item}）完全失去高亮、跳转、补全能力——这不是插件冲突，而是 VS Code 根本没把 .tpl 关联到任何语言模式。
确认当前语言模式是否为 Smarty
打开一个 .tpl 文件，在 VS Code 窗口右下角查看当前语言标识。如果显示的是 Plain Text、HTML 或 PHP，说明未启用 Smarty 支持。Smarty 本身没有官方语言扩展，需手动绑定或借助第三方扩展实现语法识别。
- 点击右下角语言标识 → 输入
Configure File Association for '.tpl'→ 选择smarty（若已安装支持 Smarty 的扩展） - 若列表中无
smarty，说明尚未安装兼容扩展，不能仅靠文件关联解决 - 临时切换：按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），运行Change Language Mode，再选smarty
安装并配置 vscode-smarty 插件
vscode-smarty 是目前最轻量、维护较活跃的 Smarty 语法支持扩展（注意不是 smarty 或 smarty-template，后者多已停更或不兼容新 VS Code 版本）。它提供基础高亮、括号匹配、部分注释识别，但不提供 PHP 补全（因 {php}...{/php} 块内才是真实 PHP 代码）。
- 在 VS Code 扩展市场搜索
vscode-smarty，作者为smtrk，安装后重启 VS Code - 安装后，
.tpl文件仍可能默认用HTML打开，需手动执行一次Change Language Mode → smarty - 如需全局默认：在
settings.json中添加"files.associations": { "*.tpl": "smarty" } - 该扩展不处理
{literal}...{/literal}内的 JS/CSS 高亮，属正常限制，勿误判为失效
让 PHP 代码块（{php}...{/php}）获得真正 PHP 支持
vscode-smarty 仅做外层模板语法着色，对 {php}...{/php} 块内的 PHP 代码无解析能力。要获得变量跳转、函数提示、错误检查等完整 PHP 功能，必须启用 PHP 语言服务嵌入支持——这需要 VS Code 1.84+ 和 PHP Intelephense 或 PHP Tools 配合。
立即学习“PHP免费学习笔记（深入）”；
- 确保已安装
PHP Intelephense（推荐）或PHP Tools - 在
settings.json中启用嵌入语言支持："intelephense.embeddedLanguages": true
- Intelephense 默认只识别
<?php ... ?>和= ... ?>，需额外声明 Smarty 的 PHP 块："intelephense.environment.includePaths": ["./"], "intelephense.stubs": ["php"]
（此项非必需，但避免 stub 缺失报错） - 注意：
{php}...{/php}不是标准 PHP 嵌入语法，Intelephense 实际仍无法索引其中的函数调用；如强依赖此功能，建议改用{assign var="x" value=$obj->method()}等 Smarty 原生方式，或直接在 PHP 层预处理数据
替代方案：用 .php 后缀 + 手动语言切换
如果项目中 .tpl 文件实际混写了大量 PHP 逻辑（违反 Smarty 设计初衷），强行套用模板扩展反而增加维护成本。此时更务实的做法是：
- 将文件保存为
.php后缀（如index.php），利用 VS Code 原生 PHP 支持 - 在文件顶部加注释告知用途：
<?php /* @template */ ?> {* Smarty template rendered as PHP file *} {$title|escape} - 通过
Change Language Mode → PHP手动切换，避免被误判为纯 PHP 脚本执行 - 此法绕过所有模板扩展兼容性问题，适合遗留项目快速救急，但会丢失
{include}、{section}等纯 Smarty 结构的语义提示
Smarty 语法高亮只是表层，真正卡住开发效率的往往是 {php}...{/php} 块内无法跳转到类方法、变量定义缺失提示——这不是配置能彻底解决的，本质是模板引擎与 IDE 语言服务的边界问题。别花时间找“完美支持 Smarty 的 PHP 全功能插件”，优先把逻辑从模板里抽出去。
