用途:系统化地把 Lightning Web Components(及 Aura 组件)从 SLDS 1 迁移到 SLDS 2,借助 SLDS linter 与分规则指南修复各类样式钩子违规。
主要能力:覆盖颜色、间距、尺寸、排版、边框/圆角、阴影六类样式钩子(前缀分别为 --slds-g-color-、--slds-g-spacing-、--slds-g-sizing-、--slds-g-font-、--slds-g-radius-border-/--slds-g-sizing-border-、--slds-g-shadow-*)。可处理四类违规:no-hardcoded-values-slds2、lwc-token-to-slds-hook、no-slds-class-overrides、no-deprecated-tokens-slds1。
使用方式:前置条件为 Node.js 14.x 以上、可访问组件 CSS 与标记文件(LWC 的 .html、Aura 的 .cmp)、终端访问权限,建议有 Git 备份。第一步必须运行 npx @salesforce-ux/slds-linter@latest lint --fix .,然后分析输出、按类型修复、选择正确钩子,最后反复运行 npx @salesforce-ux/slds-linter@latest lint . 直到 0 errors。所有钩子需带 fallback,如 var(--slds-g-hook, originalValue)。类覆盖需同时改 CSS 与标记,保留原 SLDS 类。颜色钩子需先读 color-hooks-decision-guide.md 按上下文选择,非颜色钩子按编号刻度映射。
限制:不得自造钩子名;不得改动 100%、auto、0、inherit、none、flex:1 等布局值;无近似匹配时保持原样;只使用编号刻度(如 spacing-4),不存在 spacing-medium 等命名钩子。资料未提供具体收费、平台支持范围与效果数据。