vue-vben-admin 启动报 TypeError: str.matchAll is not a function 怎么排查【免费下载链接】vue-vben-adminA modern vue admin panel built with Vue3, Shadcn UI, Vite, TypeScript, and Monorepo. Its fast!项目地址: https://gitcode.com/GitHub_Trending/vu/vue-vben-admin在本地首次运行 vue-vben-admin或者更新代码后重新安装依赖启动项目时终端可能抛出TypeError: str.matchAll is not a function堆栈指向node_modules内的purge-icons/core。项目 FAQ 将这条报错单独列为「启动报错」场景并给出了明确的排查方向检查本机 Node.js 版本号是否符合项目要求。本文按这个方向走一遍完整的排查与验证路径。识别报错FAQ「启动报错」一节列出了该错误的信息文档示例TypeError: str.matchAll is not a function at Object.extractor (vue-vben-admin-main\node_modulespurge-icons\core\dist\index.js:146:27) at Extract (vue-vben-admin-main\node_modulespurge-icons\core\dist\index.js:173:54)原文的结论是当出现以下错误信息时请检查你的 nodejs 版本号是否符合要求也就是说FAQ 没有给出其他候选原因排查的第一检查项就是 Node.js 版本。查看 Node.js 版本是否达标快速开始声明了项目的硬性环境要求Node.js 22.18.0 及以上版本推荐使用 fnm、nvm 或者直接使用 pnpm 进行版本管理Git 任意版本。用以下命令查看当前版本来自快速开始文档# 出现相应 node LTS版本即可 node -v另外仓库根目录 package.json 的engines字段给出了同样的约束engines: { node: ^22.18.0 || ^24.12.0, pnpm: 11.0.0 }两个来源相互印证node -v输出的版本低于 22.18.0、且不属于 24.x 系列时就落在项目不支持的区间内需要先把 Node.js 升到要求范围内再重试。切换到项目要求的 Node.js 版本文档推荐用 fnm、nvm 或 pnpmpnpm env这类版本管理工具切换 Node.js 版本具体命令文档未给出按你所用工具的常规用法操作即可目标版本满足上面「22.18.0 及以上」的要求。切换完成后再次执行node -v确认新版本已生效。随后重新执行快速开始文档「安装依赖」一节的标准流程确保依赖在新的 Node.js 环境下用项目指定的 pnpm 版本重装# 使用项目指定的pnpm版本进行依赖安装 npm i -g corepack # 安装依赖 pnpm install项目只支持用pnpm安装依赖默认由corepack拉取package.json中packageManager指定的 pnpm 版本当前为pnpm11.16.0。如果你不想用 corepack需要先禁用 corepack再用自己安装的 pnpm 执行pnpm install。重新运行项目并验证版本确认达标后在项目目录内重新启动# 启动项目 pnpm dev启动时会看到如下选择界面文档示例◆ Select the app you need to run [dev]: │ ● vben/web-antd │ ○ vben/web-antdv-next │ ○ vben/web-ele │ ○ vben/web-naive │ ○ vben/docs │ ● vben/playground不想交互选择时也可以直接运行指定应用例如pnpm run dev:antd pnpm run dev:play验证方式沿用快速开始文档的标准浏览器访问http://localhost:5555能看到项目页面即说明启动恢复正常。如果升级 Node.js 并重装依赖后pnpm dev仍报同一条matchAll错误FAQ 没有覆盖这种情况按其「说明」一节的指引到对应仓库的 GitHub issue 搜索或提问。边界说明FAQ 对这条报错只给出「检查 Node.js 版本」这一个排查方向没有展开内部成因本文不推测文档之外的原因。报错堆栈中的purge-icons/core在当前仓库的pnpm-lock.yaml中已检索不到说明该堆栈来自较早的依赖状态以最新代码配合达标版本运行仍复现该错误时已超出 FAQ 覆盖范围建议走 issue 渠道。本条报错与 FAQ 中「本地运行报错」浏览器需 Chrome 90、「运行错误」路径含中日韩文导致 404是三个不同现象不要按后两者的方案处理。【免费下载链接】vue-vben-adminA modern vue admin panel built with Vue3, Shadcn UI, Vite, TypeScript, and Monorepo. Its fast!项目地址: https://gitcode.com/GitHub_Trending/vu/vue-vben-admin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/10 5:30:50 · 阅读 1.2k vue-vben-admin 启动报 TypeError: str.matchAll is not a function 怎么排查
vue-vben-admin 启动报 TypeError: str.matchAll is not a function 怎么排查【免费下载链接】vue-vben-adminA modern vue admin panel built with Vue3, Shadcn UI, Vite, TypeScript, and Monorepo. Its fast!项目地址: https://gitcode.com/GitHub_Trending/vu/vue-vben-admin在本地首次运行 vue-vben-admin或者更新代码后重新安装依赖启动项目时终端可能抛出TypeError: str.matchAll is not a function堆栈指向node_modules内的purge-icons/core。项目 FAQ 将这条报错单独列为「启动报错」场景并给出了明确的排查方向检查本机 Node.js 版本号是否符合项目要求。本文按这个方向走一遍完整的排查与验证路径。识别报错FAQ「启动报错」一节列出了该错误的信息文档示例TypeError: str.matchAll is not a function at Object.extractor (vue-vben-admin-main\node_modulespurge-icons\core\dist\index.js:146:27) at Extract (vue-vben-admin-main\node_modulespurge-icons\core\dist\index.js:173:54)原文的结论是当出现以下错误信息时请检查你的 nodejs 版本号是否符合要求也就是说FAQ 没有给出其他候选原因排查的第一检查项就是 Node.js 版本。查看 Node.js 版本是否达标快速开始声明了项目的硬性环境要求Node.js 22.18.0 及以上版本推荐使用 fnm、nvm 或者直接使用 pnpm 进行版本管理Git 任意版本。用以下命令查看当前版本来自快速开始文档# 出现相应 node LTS版本即可 node -v另外仓库根目录 package.json 的engines字段给出了同样的约束engines: { node: ^22.18.0 || ^24.12.0, pnpm: 11.0.0 }两个来源相互印证node -v输出的版本低于 22.18.0、且不属于 24.x 系列时就落在项目不支持的区间内需要先把 Node.js 升到要求范围内再重试。切换到项目要求的 Node.js 版本文档推荐用 fnm、nvm 或 pnpmpnpm env这类版本管理工具切换 Node.js 版本具体命令文档未给出按你所用工具的常规用法操作即可目标版本满足上面「22.18.0 及以上」的要求。切换完成后再次执行node -v确认新版本已生效。随后重新执行快速开始文档「安装依赖」一节的标准流程确保依赖在新的 Node.js 环境下用项目指定的 pnpm 版本重装# 使用项目指定的pnpm版本进行依赖安装 npm i -g corepack # 安装依赖 pnpm install项目只支持用pnpm安装依赖默认由corepack拉取package.json中packageManager指定的 pnpm 版本当前为pnpm11.16.0。如果你不想用 corepack需要先禁用 corepack再用自己安装的 pnpm 执行pnpm install。重新运行项目并验证版本确认达标后在项目目录内重新启动# 启动项目 pnpm dev启动时会看到如下选择界面文档示例◆ Select the app you need to run [dev]: │ ● vben/web-antd │ ○ vben/web-antdv-next │ ○ vben/web-ele │ ○ vben/web-naive │ ○ vben/docs │ ● vben/playground不想交互选择时也可以直接运行指定应用例如pnpm run dev:antd pnpm run dev:play验证方式沿用快速开始文档的标准浏览器访问http://localhost:5555能看到项目页面即说明启动恢复正常。如果升级 Node.js 并重装依赖后pnpm dev仍报同一条matchAll错误FAQ 没有覆盖这种情况按其「说明」一节的指引到对应仓库的 GitHub issue 搜索或提问。边界说明FAQ 对这条报错只给出「检查 Node.js 版本」这一个排查方向没有展开内部成因本文不推测文档之外的原因。报错堆栈中的purge-icons/core在当前仓库的pnpm-lock.yaml中已检索不到说明该堆栈来自较早的依赖状态以最新代码配合达标版本运行仍复现该错误时已超出 FAQ 覆盖范围建议走 issue 渠道。本条报错与 FAQ 中「本地运行报错」浏览器需 Chrome 90、「运行错误」路径含中日韩文导致 404是三个不同现象不要按后两者的方案处理。【免费下载链接】vue-vben-adminA modern vue admin panel built with Vue3, Shadcn UI, Vite, TypeScript, and Monorepo. Its fast!项目地址: https://gitcode.com/GitHub_Trending/vu/vue-vben-admin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考