diff --git a/docs-vitepress/api/compile.md b/docs-vitepress/api/compile.md
index 905a6b3e38..ef00d9901b 100644
--- a/docs-vitepress/api/compile.md
+++ b/docs-vitepress/api/compile.md
@@ -1535,7 +1535,7 @@ module.exports = defineConfig({
 
 Mpx 编译 unocss 原子类的 webpack 主插件
 
-如果在使用 `@mpxjs/cli@3.x` 创建项目时选择了 unocss，会自动安装 MpxUnocssPlugin ，直接在 mpx.unocss 配置项中传入相关配置即可
+如果在使用 `@mpxjs/cli@3.x` 创建项目时选择了 unocss，脚手架会自动安装并注册 `MpxUnocssPlugin`，直接在 `mpx.unocss` 配置项中传入相关配置即可
 ```js
 // vue.config.js
 const { defineConfig } = require('@vue/cli-service')
@@ -1562,7 +1562,8 @@ yarn add -D @mpxjs/unocss-plugin
 
 ```js
   // vue.config.js
-  const MpxUnocssPlugin = require('@mpxjs/unocss-plugin')
+  const MpxUnocssPluginModule = require('@mpxjs/unocss-plugin')
+  const MpxUnocssPlugin = MpxUnocssPluginModule.default || MpxUnocssPluginModule
   const { defineConfig } = require('@vue/cli-service')
 
   module.exports = defineConfig({
@@ -1576,6 +1577,8 @@ yarn add -D @mpxjs/unocss-plugin
   })
 ```
 
+> `@mpxjs/unocss-plugin@2.11.1` 起以 ESM 形式发布。在 CommonJS 配置文件中通过 `require()` 加载时，需要兼容读取默认导出；以上写法同时兼容旧版 CommonJS 导出。在不额外启用实验参数的情况下，上述 CommonJS 兼容写法要求 Node.js 版本满足 `^20.19.0 || >=22.12.0`。
+
 插件支持配置如下：
 
 ### unoFile
diff --git a/docs-vitepress/guide/advance/utility-first-css.md b/docs-vitepress/guide/advance/utility-first-css.md
index eee16bb821..37822f7f96 100644
--- a/docs-vitepress/guide/advance/utility-first-css.md
+++ b/docs-vitepress/guide/advance/utility-first-css.md
@@ -77,7 +77,8 @@
 
 ```js
 const { defineConfig } = require('unocss')
-const presetMpx = require('@mpxjs/unocss-base')
+const presetMpxModule = require('@mpxjs/unocss-base')
+const presetMpx = presetMpxModule.default || presetMpxModule
 
 module.exports = defineConfig({
   presets: [
@@ -89,11 +90,14 @@ module.exports = defineConfig({
 3. 注册`MpxUnocssPlugin`，在`build/getPlugins`中添加如下代码：
 
 ```js
-const MpxUnocssPlugin = require('@mpxjs/unocss-plugin')
+const MpxUnocssPluginModule = require('@mpxjs/unocss-plugin')
+const MpxUnocssPlugin = MpxUnocssPluginModule.default || MpxUnocssPluginModule
 // ...
 plugins.push(new MpxUnocssPlugin())
 ```
 
+> `@mpxjs/unocss-plugin@2.11.1` 与 `@mpxjs/unocss-base@2.11.1` 起以 ESM 形式发布。在 CommonJS 配置文件中通过 `require()` 加载时，需要兼容读取默认导出；以上写法同时兼容旧版 CommonJS 导出。在不额外启用实验参数的情况下，上述 CommonJS 兼容写法要求 Node.js 版本满足 `^20.19.0 || >=22.12.0`。
+
 即可在项目模版中使用基于`unocss`的原子类功能，`unocss`默认的preset兼容`tailwindcss`/`windicss`
 ，可以通过查阅[tailwindcss文档](https://tailwindcss.com/docs/installation)、[windicss文档](https://windicss.org/utilities/general/colors.html)或[unocss可交互文档](https://unocss.dev/interactive/)进行探索使用。
 
@@ -120,10 +124,8 @@ plugins.push(new MpxUnocssPlugin())
   ```js
   // uno.config.js
   const { defineConfig } = require('unocss')
-  const presetMpx = require('@mpxjs/unocss-base')
-
-  const { defineConfig } = require("unocss")
-  const presetMpx = require("@mpxjs/unocss-base")
+  const presetMpxModule = require('@mpxjs/unocss-base')
+  const presetMpx = presetMpxModule.default || presetMpxModule
 
   module.exports = defineConfig({
     content: {
@@ -366,6 +368,3 @@ const escapeMap = {
 
 
 
-
-
-