17370845950

package.xml核心是先明确部署内容再严格遵循结构与命名规则；必须含、、三部分，version须与目标org API版本完全一致（如60.0），name和members大小写敏感且须真实存在。

直接写 package.xml 的核心是：**先明确要部署什么，再按 Salesforce 要求的结构和命名规则填进去，漏掉 version 或类型名拼错，整个部署就会失败。**

必须包含的根元素和 version 字段

package.xml 是一个最小契约文件，不是可选配置——它告诉 Salesforce “我要部署哪些元数据”，且必须严格遵循 XML Schema。最简合法结构只有三部分：、、。

• 必须与目标 org 的 API 版本完全一致，比如 org 是 Spring ’24（API v60.0），这里就得写 60.0，写成 60 或 60.0.0 都会报错 INVALID_VERSION
• 没有 块，或 为空，部署会成功但什么也不做；想部署任何东西，都得有至少一个 块
• 的 xmlns 属性不能省，必须是 http://soap.sforce.com/2006/04/metadata

types 块里 name 和 members 的写法规则

每个 块对应一种元数据类型（如 ApexClass、CustomObject）， 是类型名（大小写敏感）， 是具体成员名（也大小写敏感，且必须是实际存在的名字）。

• ApexClass 正确；apexclass 或 Apex_Class 都会报 INVALID_TYPE
• MyTriggerHandler —— 这个类名必须在源代码中真实存在，且大小写完全匹配；Salesforce 不接受通配符（如 My*），也不支持正则
• 多个成员用多个 标签，不是用逗号分隔：
  

  
    AccountTrigger
    ContactTrigger
    ApexTrigger
  

常见元数据类型的 name 值和典型 members 示例

不同元数据类型在 package.xml 中的 值和 写法差异很大，容易混淆的是自定义对象、字段、标签这些带后缀的类型：

• 自定义对象： CustomObject，Account__c（注意是对象 API 名，不是标签名）
• 自定义字段：必须和对象一起部署，不单独列在 里；字段定义包含在 Account__c.object 文件中，package.xml 只需声明对象本身
• 标签： CustomLabel，My_Custom_Label（标签名，不是标签值）
• Permission Set： PermissionSet，Sales_Executive（API 名，非界面上显示的“销售主管”）
• Lightning Web Component： LightningComponentBundle，myCounter（bundle 文件夹名）

别忽略 package.xml 的存放位置和大小限制

这个文件本身不参与部署内容，但它必须放在部署包的根目录下（和 src/ 同级或作为 zip 包顶层文件），且整个部署包解压后不能超过 50MB（含 package.xml）。

• 如果用 SFDX，sfdx force:source:deploy 会自动帮你生成 package.xml，你通常不需要手写；但用 Ant Migration Tool 或手动 zip 部署时，必须自己维护
• 部署大量小文件（比如几百个 LWC）时，package.xml 里的 行数可能上千，XML 解析可能超时；这时建议拆分成多个小包，而不是堆在一个文件里
• 不要把 package.xml 放进 src/ 目录里——它不属于源代码，而是部署指令，放错位置会导致工具误判或部署失败

真正难的不是语法，而是搞清你要部署的每个 在目标 org 里是否存在、名字是否精确匹配、依赖是否已包含——比如部署一个 Apex Class 引用了某个尚未部署的 Custom Field，package.xml 写得再对也没用。