【VitePress】项目打包异常问题总结（Could not resolve、Unexpected character ‘‘、Invalid value used as weak map key）

由于在自己的工作和学习过程中，只查看某个大佬的教程或文章无法满足自己的学习需求和解决遇到的问题，所以自己在追赶大佬们步伐的基础上，又自己总结、整理、汇总了一些资料，方便自己理解和后续回顾，同时也希望给大家带来帮助，所以才写下该篇文章。在本文中，所有参考或引用大佬们文章内容的位置，都附上了原文章链接，您可以直接前往查阅观看。在原文章内容的基础上，若无任何补充内容，同时避免直接大段摘抄大佬们的文章，该情况下也只附上了原文章链接供大家学习。本文旨在总结归纳，并希望给大家提供帮助，未用作任何商用用途。文章内容如有错误之处，望各位大佬指出。如果涉及侵权行为，将会第一时间对文章进行删除。

---

👉 个人博客主页 👈
📝 一个努力学习的程序猿

---

---

在最近的一次 VitePress 文档中心 开发过后，在打包时发生了三次报错，而每个报错通过查阅资料都能找到相关解决方案，现将遇到的问题汇总总结如下。如果大家也有相同的问题，希望能帮助到各位。本文无任何其他用途，仅用作作者自己总结。

---

1、Could not resolve ‘xxx’ from xxx

报错信息如下：

build error:
 Error: Could not resolve './img/auto_%E5%88%86%E7%B1%BB.png' from docs/menu3/DeveloperView/DEV2001.md

解决方案：

目前打包不支持包含中文字符的静态资源，只需要把中文字符去掉即可。

---

2、[rollup-plugin-dynamic-import-variables] Unexpected character ‘’

报错信息如下：

[rollup-plugin-dynamic-import-variables] Unexpected character '' 

解决方案：留意静态资源的类型后缀，笔者这里是大写的 MP4，将其改成常规类型即可。为避免大篇幅引用，具体请直接参考以下文章：

https://blog.csdn.net/love_Lie/article/details/125003210

---

3、TypeError: Invalid value used as weak map key

报错信息如下：

TypeError: Invalid value used as weak map key

解决方案：md 文档中不能使用 <font> 标签，可以用 <div> 标签、<span>标签、<p> 标签等替代。为避免大篇幅引用，具体请直接参考以下文章：

https://blog.csdn.net/weixin_42164539/article/details/125476536