Magento 2.4.6样式覆盖异常求助：自定义styles-l.less不生效

背景信息 #

我开发的Magento 2.4主题通过styles-m.less定义CSS，路径：

app/design/frontend/Vendor/theme/web/css/styles-m.less

主题按模块划分source子目录存储样式文件，示例路径：

app/design/frontend/Vendor/theme/web/css/source/home/_styles.less

问题描述 #

部分前端页面（如客户账户页）中，我主题生成的styles-m.css被Magento原生blank主题的styles-l.css覆盖。

已尝试操作 #

• 将blank主题原始styles-l.less复制到我的主题路径：

  app/design/frontend/Vendor/theme/web/css/styles-l.less
  

• 添加自定义模块样式文件：

  app/design/frontend/Vendor/theme/web/css/source/customer/_module.less
  

• 修改styles-l.less，引入自定义的customer/_module.less
• 执行命令setup:static-content:deploy -f并刷新Magento缓存

但问题未解决，生成的styles-l.css内容无变化。以下是我自定义的styles-l.less文件：

/**
 * Copyright © Magento, Inc. All rights reserved.
 * See COPYING.txt for license details.
 */

//
//  Blank theme desktop styles
//  _____________________________________________

//  These desktop styles are additional to mobile

//
//  Global lib + theme styles
//  ---------------------------------------------

@import '_styles.less';

//
//  Magento Import instructions
//  ---------------------------------------------

//@magento_import 'source/_module.less'; // Theme modules
//@magento_import 'source/_widgets.less'; // Theme widgets

//
//  Media queries collector
//  ---------------------------------------------

@import 'source/lib/_responsive.less';

@media-target: 'desktop'; // Sets target device for this file
@media-common: false; // Sets not to output common styles

//
//  Global variables override
//  ---------------------------------------------

@import 'source/_theme.less';

//
//  Extend for minor customisation
//  ---------------------------------------------

//@magento_import 'source/_extend.less';
@import 'source/customer/_module.less';

排查修复建议 #

1. 检查主题继承配置
   确认theme.xml中正确继承blank主题，避免层级错误导致样式优先级异常：

   <theme xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Config/etc/theme.xsd">
       <title>Your Theme</title>
       <parent>Magento/blank</parent>
       <media>
           <preview_image>media/preview.jpg</preview_image>
       </media>
   </theme>
   

2. 替换普通@import为Magento专属指令
   普通@import无法触发Magento的样式合并优先级机制，需改为@magento_import：

   @magento_import 'source/customer/_module.less';
   

   若需要合并所有模块基础样式，可取消注释//@magento_import 'source/_module.less';

3. 彻底清理缓存与静态文件
   仅刷新缓存可能残留旧文件，手动删除以下目录后重新部署：

   • pub/static/frontend/Vendor/theme
   • var/view_preprocessed
   • var/cache
   • var/page_cache
     再执行setup:static-content:deploy -f

4. 验证主题启用状态
   后台进入内容 > 设计 > 配置，确认对应商店视图已启用你的主题，而非blank主题。

5. 检查文件权限
   确保自定义styles-l.less和customer/_module.less权限为644，保证Magento编译进程可读取。

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