SuperAPI AI 工具集

dx-org-switch

通用与其它

查看项目

更新于 10-15 21:43

技能介绍

用途:切换 Salesforce CLI 的当前活动组织(即默认 target-org),当用户希望改变 CLI 命令所针对的组织时使用。

主要能力与步骤:

  1. 确定组织:用户提供用户名或别名(orgIdentifier)。若未提供,运行 sf org list 展示已认证组织并询问用户选择哪一个。
  2. 设置默认组织:本地(默认)执行 sf config set target-org <orgIdentifier>,仅作用于当前项目目录,适合常规项目工作。全局(仅在用户明确要求时)执行 sf config set target-org <orgIdentifier> --global,作用于系统范围所有目录,适合在项目外工作或用户要求全局作用域时使用。若失败,报告错误并建议运行 sf org login web,以防组织未授权。
  3. 验证:运行 sf config get target-org --json。注意:该 JSON 输出不包含 scope/location 字段,无法确认值是本地还是全局,只能确认值本身,例如:target-org is now set to: <value>。若失败,报告错误并建议运行 sf config get target-org。

注意事项:统一 CLI 使用 target-org 和 target-dev-hub 等键名;旧版 sfdx 键名(defaultusername、defaultdevhubusername)在此上下文中已弃用。sf CLI 的 config set 没有 --local 或 --scope 标志,本地作用域是默认行为。若设置配置后组织未改变,检查是否设置了 SF_TARGET_ORG——环境变量会覆盖配置值。

使用方式:按上述步骤依次执行命令,需要用户提供组织标识或从 sf org list 中选择。限制:需要已认证的组织;全局设置需用户明确要求;验证命令无法显示作用域。

适用场景:在 Salesforce 项目开发中需要切换 CLI 指向的组织,或在多个已认证组织间快速切换默认目标。