如何在自定义模块中覆盖Magento 2的.phtml文件？

针对你遇到的覆盖vendor/magento/module-customer/view/frontend/templates/account/dashboard/info.phtml无效的问题，按以下步骤排查修复：

• 1. 确认自定义模块已启用
  执行命令检查模块状态：

  bin/magento module:status
  

  如果NewModule_NewModuleTest在Disabled List里，执行启用命令：

  bin/magento module:enable NewModule_NewModuleTest
  bin/magento setup:upgrade
  

  也可以手动检查app/etc/config.php，确保存在'NewModule_NewModuleTest' => 1,

• 2. 添加布局XML配置（关键缺失步骤）
  Magento 2覆盖模板需要通过布局文件指定替换规则，在你的模块路径下创建布局文件：
  src/app/code/NewModule/NewModuleTest/view/frontend/layout/customer_account_dashboard_info.xml
  写入以下内容：

  <?xml version="1.0"?>
  <page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
      <body>
          <referenceBlock name="customer_account_dashboard_info">
              <action method="setTemplate">
                  <argument name="template" xsi:type="string">NewModule_NewModuleTest::customer/account/dashboard/info.phtml</argument>
              </action>
          </referenceBlock>
      </body>
  </page>
  

  这里的customer_account_dashboard_info是原模块中对应模板的Block名称，必须准确匹配。

• 3. 检查模板文件路径是否正确
  你当前的模板路径src/app/code/NewModule/NewModuleTest/view/frontend/templates/customer/account/dashboard/info.phtml是正确的，和布局配置里的NewModule_NewModuleTest::customer/account/dashboard/info.phtml对应（::后面的路径就是templates目录下的相对路径）。

• 4. 彻底清理缓存与静态文件
  执行更彻底的缓存清理命令：

  bin/magento cache:flush
  

  如果你的Magento运行在生产模式，还需要重新部署静态内容：

  bin/magento setup:static-content:deploy -f
  

  开发模式下静态文件自动生成，但Docker环境可能需要重启容器确保文件同步。

• 5. 检查Docker环境文件权限
  确保自定义模块的文件权限正确，让Magento进程能读取：

  # 进入Docker容器后执行，根据容器内的web用户调整（通常是www-data）
  chown -R www-data:www-data /var/www/html/app/code/NewModule
  

  部分Docker挂载配置会导致宿主机文件权限和容器内不一致，这是常见的文件读取失败原因。

• 6. 验证模块加载状态
  执行命令查看已加载的模块：

  bin/magento module:status --enabled
  

  确认NewModule_NewModuleTest在列表中，同时可以查看var/log/system.log和var/log/exception.log，检查是否有模块加载或模板读取的错误信息。

内容的提问来源于stack exchange，提问作者Stern