使用VS Code部署类时出现‘Error deploying or retrieving source’报错求助

问题原因 #

你尝试部署的类文件所在目录未被添加到项目根目录下sfdx-project.json文件的packageDirectories配置项中，Salesforce CLI仅会识别该配置内的目录作为合法的部署源路径。

解决步骤 #

• 打开项目根目录下的sfdx-project.json文件。
• 定位到packageDirectories字段（数组结构），将你要部署的类所在的相对项目根目录的路径添加到数组中。
  • 示例配置（假设新增目录为custom-packages/my-classes）：

    {
      "packageDirectories": [
        {"path": "force-app", "default": true},
        {"path": "custom-packages/my-classes"}
      ],
      "namespace": "",
      "sfdcLoginUrl": "https://login.salesforce.com",
      "sourceApiVersion": "58.0"
    }
    

• 保存文件后，重新执行右键「部署到组织」操作。

额外检查项 #

• 确保添加的路径是相对路径，而非绝对路径，且与实际目录结构完全匹配（注意大小写，CLI对路径大小写敏感）。
• 若不确定已配置的包目录，可在项目根目录执行命令sfdx force:project:list查看，对比要部署的文件路径是否匹配。

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