Magento 2.4.6-p2环境下.less文件编译失败问题求助

问题情况 #

• 本地Docker部署Magento Cloud 2.4.6-p2，站点运行正常；基于Luma创建自定义主题，Grunt配置完成
• 执行grunt clean、grunt exec无异常，但grunt less时报错：pub/static/frontend/Magento/blank/en_US/css/source/_reset.less中unit函数第一个参数必须为数字
• 额外异常：该文件在VS Code中可见但无法打开，新建同名文件提示已存在

已尝试的无效操作 #

• 清理Magento缓存
• 删除pub/static目录下的静态文件

问题根源 #

Magento安装过程中出现错误，导致_reset.less文件内容损坏（比如unit函数参数被替换为非数字值），同时文件系统层面出现索引异常，引发VS Code的文件识别问题

解决步骤 #

1. 替换损坏的核心文件
   • 从Magento官方2.4.6-p2安装包中取出vendor/magento/theme-frontend-blank/web/css/source/_reset.less文件
   • 将其替换到Docker容器内对应路径，或宿主机挂载目录的对应位置
2. 修复文件系统异常
   • 进入Docker容器，执行ls -l pub/static/frontend/Magento/blank/en_US/css/source/查看文件权限与状态
   • 若文件无法正常删除，尝试强制删除：rm -f pub/static/frontend/Magento/blank/en_US/css/source/_reset.less，再将官方文件复制到对应路径
3. 重新执行编译验证
   • 按顺序执行grunt clean → grunt exec → grunt less，确认编译正常

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