package.xml核心是先明确部署内容再严格遵循结构与命名规则；必须含、、三部分，version须与目标org API版本完全一致（如60.0），name和members大小写敏感且须真实存在。
直接写 package.xml 的核心是：**先明确要部署什么，再按 Salesforce 要求的结构和命名规则填进去，漏掉 version 或类型名拼错，整个部署就会失败。**
必须包含的根元素和 version 字段
package.xml 是一个最小契约文件，不是可选配置——它告诉 Salesforce “我要部署哪些元数据”，且必须严格遵循 XML Schema。最简合法结构只有三部分：<package></package>、<types></types>、<version></version>。
-
<version></version>必须与目标 org 的 API 版本完全一致，比如 org 是 Spring ’24（API v60.0），这里就得写<version>60.0</version>，写成60或60.0.0都会报错INVALID_VERSION - 没有
<types></types>块，或<types></types>为空，部署会成功但什么也不做；想部署任何东西，都得有至少一个<types></types>块 -
<package></package>的xmlns属性不能省，必须是http://soap.sforce.com/2006/04/metadata
types 块里 name 和 members 的写法规则
每个 <types></types> 块对应一种元数据类型（如 ApexClass、CustomObject），<name></name> 是类型名（大小写敏感），<members></members> 是具体成员名（也大小写敏感，且必须是实际存在的名字）。
-
<name>ApexClass</name>正确；<name>apexclass</name>或<name>Apex_Class</name>都会报INVALID_TYPE -
<members>MyTriggerHandler</members>—— 这个类名必须在源代码中真实存在，且大小写完全匹配；Salesforce 不接受通配符（如My*），也不支持正则 - 多个成员用多个
<members></members>标签，不是用逗号分隔：<types> <members>AccountTrigger</members> <members>ContactTrigger</members> <name>ApexTrigger</name> </types>
常见元数据类型的 name 值和典型 members 示例
不同元数据类型在 package.xml 中的 <name></name> 值和 <members></members> 写法差异很大，容易混淆的是自定义对象、字段、标签这些带后缀的类型：
- 自定义对象：
<name>CustomObject</name>，<members>Account__c</members>（注意是对象 API 名，不是标签名） - 自定义字段：必须和对象一起部署，不单独列在
<members></members>里；字段定义包含在Account__c.object文件中，package.xml只需声明对象本身 - 标签：
<name>CustomLabel</name>，<members>My_Custom_Label</members>（标签名，不是标签值） - Permission Set：
<name>PermissionSet</name>，<members>Sales_Executive</members>（API 名，非界面上显示的“销售主管”） - Lightning Web Component：
<name>LightningComponentBundle</name>，<members>myCounter</members>（bundle 文件夹名）
别忽略 package.xml 的存放位置和大小限制
这个文件本身不参与部署内容，但它必须放在部署包的根目录下（和 src/ 同级或作为 zip 包顶层文件），且整个部署包解压后不能超过 50MB（含 package.xml）。
- 如果用 SFDX，
sfdx force:source:deploy会自动帮你生成package.xml，你通常不需要手写；但用 Ant Migration Tool 或手动 zip 部署时，必须自己维护 - 部署大量小文件（比如几百个 LWC）时，
package.xml里的<members></members>行数可能上千，XML 解析可能超时；这时建议拆分成多个小包，而不是堆在一个文件里 - 不要把
package.xml放进src/目录里——它不属于源代码，而是部署指令，放错位置会导致工具误判或部署失败
真正难的不是语法，而是搞清你要部署的每个 <members></members> 在目标 org 里是否存在、名字是否精确匹配、依赖是否已包含——比如部署一个 Apex Class 引用了某个尚未部署的 Custom Field，package.xml 写得再对也没用。
