ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

vue-vben-admin 项目路径含中文导致 Failed to resolve module import 报错怎么解决

vue-vben-admin 项目路径含中文导致 Failed to resolve module import 报错怎么解决 vue-vben-admin 项目路径含中文导致 Failed to resolve module import 报错怎么解决【免费下载链接】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 克隆到本地、装好依赖后执行pnpm dev终端里 vite 报模块解析失败报错中的 import 路径是一串错乱的字符串类似antdv-next/dist/antd.css-vben-adminode_modulesantdv-nextdistantd.css。这个报错的根因是项目全路径包含所有父级目录中出现了中文、日文、韩文vite 组装模块绝对路径时路径访问 404导致模块无法解析。本文按官方 FAQ 与快速开始文档给出确认原因、修正路径、重新启动并验证的完整操作路径。报错长什么样怎么确认是这个原因出现本地运行问题先查 常见问题 FAQ 的「运行错误」一节。当终端输出与文档示例一致或高度相似时[vite] Failed to resolve module import antdv-next/dist/antd.css-vben-adminode_modulesantdv-nextdistantd.css. (imported by //setup/antdv-next/index.ts)以上为文档示例输出。注意其中模块路径是项目名、node_modules与antd.css拼在一起后被破坏的错乱串这是该场景的典型特征。文档给出的判定规则是项目全路径包含所有父级路径不能出现中文、日文、韩文否则会出现路径访问 404进而导致这个报错。快速开始文档 在「获取源码」步骤也用 danger 提示了同样的约束且限制范围更宽存放代码的目录及所有父级目录不能存在中文、韩文、日文以及空格否则安装依赖后启动会出错。两份文档的限制清单略有差异FAQ 列中、日、韩三种文字快速开始额外加了空格本文按更严格的口径检查路径各级目录名既不含中、日、韩文字也不含空格。检查项目全路径是否违反约束修正前先确认项目确实放在违规路径上取得项目根目录的绝对路径即包含package.json、node_modules的那一层目录逐级检查该路径中每一级目录名只要任意一级包含中文、日文、韩文字符或空格就命中该问题文档没有提供专门的检查命令判定依据就是路径字符串本身与 node 版本、node_modules内容无关。把项目移到合规路径后重新安装并启动确认路径违规后唯一的处理方向是让项目及其所有父级路径满足约束文档没有提供改配置绕过的办法。两种做法把现有项目目录整体移动到一个全英文、不含空格的路径下或者按快速开始文档的「获取源码」步骤重新 clone 源码到一个全英文、不含空格的路径。然后在新位置的项目目录内按 快速开始 安装依赖并启动# 进入项目目录 cd vue-vben-admin # 使用项目指定的pnpm版本进行依赖安装 npm i -g corepack # 安装依赖 pnpm install这几条命令的前提是快速开始文档列出的环境要求Node.js 22.18.0 及以上版本文档推荐用 fnm、nvm 或 pnpm 做版本管理Git 任意版本。可用node -v和git -v确认版本满足要求。另外项目只支持使用pnpm安装依赖默认通过corepack安装项目指定的pnpm版本。验证启动是否恢复启动项目# 启动项目 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:ele、pnpm run dev:naive、pnpm run dev:docs、pnpm run dev:play。成功条件按文档描述判断启动后终端不再出现Failed to resolve module import报错并且可以在浏览器访问http://localhost:5555看到项目页面。可选分支如果移到新路径后依赖安装或启动仍有问题按 FAQ「依赖安装问题」一节的说法可以尝试执行pnpm run reinstall。容易混淆的其他启动报错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 版本号是否符合要求它和路径是否含中文无关排查方向不同不要按本文的路径方案处理。最后注意一点路径约束是在「获取源码」阶段就要满足的前置条件。如果 clone 时就放在了违规路径安装依赖后启动就会出错事后只能靠移动项目或重新 clone解决这是该问题唯一的修复路径。【免费下载链接】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),仅供参考
返回列表