dist反编译 vue（vue打包后dist反编译）



VuePress v2 的一些主要改动和优化：

• VuePress v2 现在使用 Vue 3 ，因此你要保证你的组件和其他客户端文件是适用于 Vue 3 的。
• VuePress v2 是使用 TypeScript 开发的，因此它现在提供了更好的类型支持。我们强烈推荐你使用 TypeScript 来开发插件和主题。 VuePress 配置文件也同样支持 TypeScript ，你可以直接使用 。
• VuePress v2 支持使用 Webpack 和 Vite 作为打包工具。你可以在配置文件中选择你喜欢的打包工具来使用。
• VuePress v2 现在是纯 ESM 包， CommonJS 格式的配置文件不再被支持。

VuePress v2 的核心思想和流程是和 v1 一致的，但 v2 API 经过了重新设计，更加标准化。因此在将现有的 v1 项目迁移至 v2 时，你很可能会遇到一些 Breaking Changes 。本指南将帮助你将 v1 的站点 / 插件 / 主题迁移至 v2 。

• 如果你是一个普通用户，你需要阅读 给用户 的指南。
• 如果你是一个插件作者，你需要阅读 给插件作者 的指南。
• 如果你是一个主题作者，你需要阅读 给主题作者 的指南。

配置文件应该使用 ESM 格式， CommonJS 格式的配置文件已不再支持。

现在我们支持使用不同的打包工具。

你需要安装并在配置文件中使用 Vite 打包工具：

或者使用 Webpack 打包工具：

不再支持通过字符串使用主题，默认主题也不再集成到 vuepress 包中。

你需要安装并在配置文件中使用默认主题：

移除。直接向主题传入配置。

不再支持通过字符串使用插件。需要直接引入插件。

默认值从 更改为 。

移除。

你可以手动在 Hook 中监听文件变化。

重命名为 。

移除。

相同的功能改在 @vuepress/plugin-prismjs 和 @vuepress/plugin-shiki 提供。

移除。

移动至 。

有改动。

参考

移除。

在 Hook 中使用 markdown-it 插件。

移除。

使用 Hook 。

移动至 。

所有 Webpack 相关的配置都移动至 的配置项中，包括：

• ：默认值从 更改为

请参考 。

移除。

改为使用 。例如：

和以下结构相同：

• ：移除
• ：移除
• ：移除（v1 文档中未列出）
• ：移除（v1 文档中未列出）
• ：重命名为

参考 。

VuePress v1 的 Stylus 调色板系统 （即 和 ） 不再由 VuePress Core 默认提供支持。

调色板系统提取到了 @vuepress/plugin-palette 当中。

主题作者可以使用自己的方式来为用户提供自定义样式的能力，而不必被限制在 Stylus 当中。

如果你使用的是默认主题，那么调色板系统仍然存在，但改为使用 SASS ，并且大部分变量都迁移为 CSS 变量。参考 默认主题 > 样式 。

重命名为 ，使用方法也有改动。

参考 。

在该目录下的文件不会被自动注册为 Vue 组件。

你需要使用 @vuepress/plugin-register-components ，或者在 中手动注册你的组件。

即使该目录存在，也不会被隐式默认当作本地主题目录。

你需要在 配置项中显式引入并使用本地主题。

• Markdown 插槽不再被支持。
• Markdown 图片语法不再支持 Webpack 别名。不以 开头的链接也会被识别为相对路径，这与原生 Markdown 图片语法的行为一致。如果你想要使用 Webpack 别名，或者使用来自外部包的图片，你应该使用 标签。

移除。

• ：修改为 ，意味着 不再是 选项的缩写，并且 选项的值不再是可选的。
• ：重命名为 。

• 和 被 代码选项卡 替代
• • 调色板变量重命名为
  • Prop 现在只接受 、 和

默认主题的调色板系统迁移为 SASS 和 CSS 变量。

参考 默认主题 > 样式 。

默认主题的配置有大量变更，建议你阅读 v2 的默认主题配置参考文档来进行迁移。

参考 默认主题 > 配置 。

这里仅列出部分要注意的变更：

查看 v2 版本的官方插件文档。

v1 的主题和插件和 v2 并不兼容。

请确保你在使用的主题和插件已经支持 v2 ，并前往它们各自的文档查看迁移指南。

一些主要的 Breaking Changes ：

• 你不能再在你的插件中使用其他插件了，这避免了很多由于插件嵌套引发的问题。如果你的插件依赖于别的插件，你可以在文档中列出他们，并让用户手动引入。或者，你也可以向用户提供一个插件数组以方便使用。
• 大部分 v1 Hook 都在 v2 中存在等效的 Hook 或实现方式。唯一的例外是 ，它被移除了。
• Webpack 相关的 Hook 都被移除了，因为 VuePress Core 已经和 Webpack 解耦了。你可以尝试使用 Hook 来进行相似的操作，但要注意应适配所有不同的打包工具。

你可以参考 来了解如何开发一个 v2 插件。

• ：移除
• ：重命名为
• ：重命名为
• ：重命名为
• ：移除，改为在 Hook 中使用
• ：移除，改为在 Hook 中使用
• ：移除，使用 Hook
• ：移除，使用 Hook
• ：移除，使用 Hook
• ：重命名为
• ：移除
• ：重命名为
• ：移除
• ：移除
• ：移除
• ：移除
• ：移除

参考 。

请先浏览 插件 API 变更 和 主题 API 变更。

虽然我们不允许在插件中使用其他插件了，但是你仍然可以在你的主题中使用插件。

一些主要的 Breaking Changes ：

• 所谓的 主题目录结构约定 不再存在。
  • 文件不会被隐式作为 Client App Enhance 文件。你需要在 Hook 中显式指定它。
  • 目录下的文件不会被自动注册为 Vue 组件。你需要使用 @vuepress/plugin-register-components ，或者在 中手动注册组件。
  • 目录下的文件不会被自动注册为布局组件。你需要在 中通过 来显式指定。
  • 目录下的文件不会被自动用作 dev / ssr 的模板。你需要通过 和 配置项来显式指定。
  • 你始终需要提供一个合法的 JS 入口文件，不要再使用 作为主题入口。
• 已经从用户配置和站点数据中移除。如果你想要像 v1 一样通过 来访问 ，我们现在建议使用 @vuepress/plugin-theme-data 插件和它提供的 Composition API 。
• Stylus 不再是默认的 CSS 预处理器，并且 Stylus 调色板系统不再被默认支持。如果你仍然想要使用和 v1 类似的调色板系统，可以使用 @vuepress/plugin-palette 。
• 由 Prism.js 提供的 Markdown 代码块的语法高亮不再被默认支持。你可以选择使用 @vuepress/plugin-prismjs 或 @vuepress/plugin-shiki ，或者用你自己的方式实现语法高亮。
• 考虑到可扩展性， 不再可用。查看 了解如何在 v2 中获取页面的数据。

你可以参考 来了解如何开发一个 v2 主题。

移除。

现在你需要在客户端配置文件中设置布局组件。

参考 。

重命名为 。

你仍然可以通过 来继承一个父主题，这将会继承其插件和布局等。

你可以参考 默认主题 > 继承 来了解如何继承默认主题。

和 别名默认被移除了，但你仍然可以使用类似的方式来开发一个可继承的主题，参考 。

版权声明：

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如若内容造成侵权、违法违规、事实不符，请将相关资料发送至xkadmin@xkablog.com进行投诉反馈，一经查实，立即处理！

转载请注明出处，原文链接：https://www.xkablog.com/qdvuejs/80250.html