LWC API Versioning

同学们，今天我们来了解一个 LWC 组件开发中非常重要的新要求——自定义组件的版本控制。这个变化从 24 年冬季，也就是我们说的 Winter '24 开始引入，当时只要你的 API 版本在 59.0 及以上，就可以选择性地给组件加上版本号。从 25 年春季起，所有新建或修改的自定义组件都强制要求有版本了。也就是说，没加版本号的组件再也无法保存。 那么，为什么要这么做呢？简单理解，API 版本就像给组件的代码拍了一张快照。一个组件里的 HTML、CSS、JS 每个文件都会绑定一个特定的 Salesforce 版本。这样一来，不管 Salesforce 未来怎么升级底层平台，你的组件都会在当初指定的那个版本环境下稳定运行，行为不会突然改变，这就是稳定性的保障。 以前保存的那些没有版本号的老组件，还能继续用，不会受影响。但只要你哪天想修改它，就必须先给它设定一个 API 版本才能保存。如果直接修改没版本的组件再点保存，系统就会直接报错，不让你通过。 所以，现在做 LWC 开发时，记得在组件文件的配置里（也就是 meta.xml 文件或源代码文件的开头），清晰地标上 API 版本。这既是对组件运行环境的锁定，也是 Salesforce 推动大家规范化开发的新底线。很简单但很关键，一定要记住。