用途:系统化地把 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-)。可处理四类违规:硬编码值、--lwc- 废弃 token、SLDS 类覆盖、SLDS 1 的 t()/token() 旧语法。
使用方式:先运行 npx @salesforce-ux/slds-linter@latest lint --fix .(必做,不可跳过),再根据输出逐条修复;颜色属性需先读颜色钩子决策指南,非颜色钩子按数值对照表匹配;类覆盖需同时改 CSS 与标记(.html 或 .cmp),保留原 SLDS 类并新增组件前缀类。修复后反复运行 npx @salesforce-ux/slds-linter@latest lint . 直到 0 errors。所有钩子须带 fallback,如 var(--slds-g-hook, originalValue)。
适用场景:LWC/Aura 组件样式升级、废弃 token 清理、类覆盖规范化。
限制:需 Node.js 14.x 以上;不得自造钩子名;不得改动 100%、auto、0、inherit、none 等布局值;无精确匹配的硬编码值应保持原样;仅使用编号刻度(如 spacing-4),不存在 spacing-medium 等命名钩子。具体收费与平台信息暂未提供。