修改商品页或结账页时不知道内容来自哪个 PHTML,可以使用 Template Path Hints。它会在页面区块外显示模板路径和 Block 类,适合快速定位主题覆盖关系。
在开发环境的高级开发配置中开启模板路径提示,并按需要显示 Block 名称。多网站环境要确认当前 Store View,配置保存后清理配置与全页缓存。
如果后台开关不可见,先确认应用处于允许开发配置的环境;也可以通过配置命令在指定作用域设置,但不要把调试配置写死到生产部署文件。
为什么不建议在正式站直接开启
路径提示会改变页面输出,并暴露模块、主题和服务器目录结构。确需在线排查时,应限制访问 IP、缩短开启时间,并在完成后恢复配置和缓存。
找到模板后还要确认主题继承:优先在自定义主题中覆盖最小文件,不要修改 vendor 内原文件。否则下一次 Composer 更新会覆盖改动。

