关于 dx-org-switch
用于通过 Salesforce 统一 `sf` CLI 设置并验证默认组织的技能,供 Salesforce 开发者选择项目级设置,或按明确要求设置全局默认值。
主要功能
- 01按用户名或别名选择组织
- 02未指定时列出已认证组织
- 03设置项目级默认组织
- 04按要求设置全局默认组织
- 05验证已配置的目标组织
适用场景
- 01切换 Salesforce 项目使用的组织
- 02为项目目录外的工作设置组织
- 03检查 CLI 当前指向的组织
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ forcedotcom/ sf-skills --skill dx-org-switch安装后在 Claude Code 中输入/dx-org-switch确认已加载。
详细介绍
步骤
- 确定组织:用户提供用户名或别名(
orgIdentifier)。如果未提供,运行sf org list显示已通过身份验证的组织,并询问用户要使用哪一个。 - 设置默认组织:
- 本地(默认):
sf config set target-org <orgIdentifier>- 仅适用于当前项目目录。常规项目工作请使用此设置。
- 全局(仅在用户明确要求时):
sf config set target-org <orgIdentifier> --global- 适用于所有目录,在系统范围内生效。用于在项目外工作,或用户要求全局范围时。
- 如果失败,请报告错误,并建议在组织可能未获授权时运行
sf org login web。
- 本地(默认):
- 验证:
sf config get target-org --json- 注意:JSON 输出不包含作用域/位置字段,因此无法确认该值是本地还是全局。只需确认该值,例如:
target-org is now set to: <value> - 如果失败,请报告错误,并建议运行
sf config get target-org。
备注
- Unified CLI 使用
target-org和target-dev-hub等键。在此上下文中,旧版 sfdx 键(defaultusername、defaultdevhubusername)已弃用。 - sf CLI 的 config set 没有
--local或--scope标志。本地作用域是默认行为。 - 如果设置配置后组织未发生变化,请检查是否设置了
SF_TARGET_ORG——环境变量会覆盖配置值。 - Salesforce CLI config(unified)参考:https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_config_commands_unified.htm#cli_reference_config_set_unified
评论
支持 Markdown