VS Code从Salesforce下载元数据时提示CustomLabels缺失fullName错误

问题详情 #

• 重装系统及VS Code后，从Salesforce Org Browser下载新增元数据时触发错误：Missing fullName on CustomLabel in \force-app\main\default\labels\CustomLabels.labels-meta.xml
• 未主动下载自定义标签，但检索任何现有元数据（无关项）都会触发该错误：
  1. 操作时先弹出提示“Are you sure you want to overwrite ...?”
  2. 点击【Overwrite】后仍出现相同错误
• 仅检索自定义标签时报错，其他已修改的现有项检索正常

错误日志 #

16:20:46.23 Starting SFDX: Retrieve This Source from Org

Missing fullName on CustomLabel in \force-app\main\default\labels\CustomLabels.labels-meta.xml

解决步骤 #

1. 检查并修复本地CustomLabels文件
   打开\force-app\main\default\labels\CustomLabels.labels-meta.xml，确认每个<CustomLabel>节点都包含<fullName>字段（值需与标签API名称一致）。如果有缺失或错误，手动修正。
   正确节点示例：

   <CustomLabel>
       <fullName>My_Custom_Label</fullName>
       <language>en_US</language>
       <protected>false</protected>
       <shortDescription>My Label</shortDescription>
       <value>Hello World</value>
   </CustomLabel>
   

2. 重新获取自定义标签元数据
   如果本地文件损坏严重，直接删除\force-app\main\default\labels文件夹，然后在VS Code终端执行命令重新检索：

   sfdx force:source:retrieve -m CustomLabel
   

3. 更新SFDX CLI
   旧版CLI可能存在兼容性问题，执行命令更新到最新版本：

   sfdx update
   

4. 清除本地缓存
   关闭VS Code，删除项目根目录下的.sfdx文件夹，重启后重新连接Salesforce Org。

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