# Weapp-vite > 面向小程序的现代工程化工具链，覆盖开发、构建、Vue SFC、Wevu、自动化、MCP 与多平台能力。 ## Table of Contents ### 目录结构 - [目录结构](/guide/directory-structure.md): Weapp-vite 的目录结构总览页，按 Nuxt 式目录索引组织，左侧目录项为独立路由，右侧为每个目录或文件的详细说明。 #### 根目录 - [vite.config.ts](/guide/directory-structure/vite-config.md): Weapp-vite 配置入口文件，负责定义 srcRoot、自动路由、分包、自动导入组件等行为。 - [project.config.json](/guide/directory-structure/project-config.md): 微信开发者工具项目配置文件，定义 miniprogramRoot、appid 等平台侧参数。 - [package.json](/guide/directory-structure/package-json.md): 项目脚本与依赖入口，通常承载 dev、build、open 等 weapp-vite 命令。 - [public](/guide/directory-structure/public.md): 构建时原样复制到产物目录的静态资源目录，适合放无需参与模块分析和编译转换的文件。 #### 源码根目录 - [](/guide/directory-structure/src-root.md): Weapp-vite 的源码根目录概念，所有 pages、components、分包、自动生成类型文件都基于它定位。 #### 应用入口 - [app.(js|ts)](/guide/directory-structure/app-ts.md): 应用脚本入口，支持 JavaScript 与 TypeScript，承载 App 生命周期和全局初始化逻辑。 - [app.vue](/guide/directory-structure/app-vue.md): Vue SFC 形式的应用入口，可在一个文件中组织脚本、defineAppJson 宏与样式。 - [app.json(.js|.ts)?](/guide/directory-structure/app-json.md): 应用配置入口，既支持原生 JSON，也支持 app.json.js 和 app.json.ts 这类脚本化形式。 - [app.(css|scss|wxss|...)](/guide/directory-structure/app-style.md): 应用级全局样式入口，支持 CSS、WXSS 与常见预处理器后缀。 - [custom-tab-bar](/guide/directory-structure/custom-tab-bar.md): 微信自定义 tabBar 的固定保留目录，必须与 app.json 处于同一个 srcRoot 下。 - [app-bar](/guide/directory-structure/app-bar.md): Skyline 全局工具栏的固定保留目录，与 appBar 配置一一对应。 #### 页面与组件 - [/layouts](/guide/directory-structure/layouts.md): 说明 srcRoot/layouts 目录的职责、命名规则，以及它如何与 definePageMeta、routeRules、setPageLayout 协同工作。 - [pages](/guide/directory-structure/pages.md): 主包页面目录，是自动路由的默认扫描入口之一，也是页面级构建产物与路由生成的核心来源。 - [components](/guide/directory-structure/components.md): 主包组件目录，默认参与自动导入组件扫描，并作为 `usingComponents` 自动补全的重要来源。 #### 分包与共享 - [](/guide/directory-structure/subpackages.md): 分包目录与分包 root 的关系说明，weapp.subPackages 才是分包边界的权威配置。 - [shared](/guide/directory-structure/shared.md): 跨主包与分包共享模块的推荐目录，用来沉淀复用逻辑、常量、样式与跨包共享能力。 - [utils](/guide/directory-structure/utils.md): 通用工具函数的推荐目录，适合放业务无关、可复用且能在主包与分包之间共享的辅助模块。 - [workers](/guide/directory-structure/workers.md): Worker 入口的推荐目录，可与 app.json 和 worker 配置联动。 #### 生成文件 - [类型声明文件](/guide/directory-structure/generated-files.md): weapp-vite 自动生成的类型与支持文件，默认输出到 .weapp-vite 目录。 ### 开始使用 - [快速开始](/guide.md): 从零创建或接入 weapp-vite 项目，快速跑通开发、构建、IDE 打开、CLI 透传与后续能力扩展。 - [什么是 Weapp-vite ?](/guide/what-is-weapp-vite.md): Weapp-vite 是一个面向微信小程序的现代构建框架：尽量不改变你写原生小程序的方式（语法、目录结构都能沿用），但把 Vite 生态、TypeScript、CSS 预处理器和更顺滑的开发/构建流程带进来。你仍然写小程序，但开发体验会更… - [CLI 命令参考](/guide/cli.md): weapp-vite CLI 命令参考，覆盖 dev、build、analyze、prepare、mcp、ide logs、generate，以及 screenshot/compare 等 weapp-ide-cli 透传规则。 - [VS Code 扩展](/guide/vscode-extension.md): 为 weapp-vite 项目安装官方 VS Code 扩展，获得命令入口、页面树、生成器、路由维护、配置提示与多端模板增强。 - [AI 协作指南](/guide/ai.md): 面向 weapp-vite 团队的 AI 协作入口，聚焦 Skills、MCP 与 llms.txt 三大章节。 - [AI Skills 使用指南](/guide/skills.md): 按任务场景选择 Weapp-vite 公开 Skills，说明安装方式、触发边界、关联文档和最小验证命令。 - [AI 任务工作流](/guide/ai-workflows.md): 将 Weapp-vite 常见 AI 协作任务拆成可执行流程，覆盖 issue 修复、文档同步、DevTools e2e、SFC 排障和原生迁移。 - [目录结构](/guide/directory-structure.md): Weapp-vite 的目录结构总览页，按 Nuxt 式目录索引组织，左侧目录项为独立路由，右侧为每个目录或文件的详细说明。 - [手动集成 Weapp-vite](/guide/manual-integration.md): 已经有运行中的微信小程序？可以按下面步骤在不依赖脚手架的情况下把 Weapp-vite 接进来。整体思路就三步：补齐配置文件 → 安装依赖 → 调整目录。 ### 原生增强 - [Vue SFC 开发](/guide/vue-sfc.md): 这里是 Vue SFC 开发的入口说明。完整内容已迁移到 Wevu 文档目录：Weapp-vite 负责编译期（.vue → 小程序产物），Wevu 负责运行期（响应式与生命周期）。 - [别名](/guide/alias.md): Weapp-vite 同时支持 **JS/TS 别名** 与 **JSON/JSONC 别名**，让你在脚本和配置文件里都能用同一套路径前缀。本页先给出最常见的配置方式，再补充一些使用建议；更细的字段说明请参考 配置文档 · JSON 配… - [npm 自动构建](/guide/npm.md): Weapp-vite 会尽量帮你把“npm 依赖怎么进小程序”这件事自动化：默认提供 **2 种自动策略**，以及 **1 个手动触发**命令。 - [生成脚手架](/guide/generate.md): Weapp-vite 自带一个生成器，用来一键生成页面/组件/App 的基础文件（页面/组件包含 js/ts、wxml、wxss、json；App 不生成 wxml）。它适合两类情况： - [自动路由（weapp-vite/auto-routes）](/guide/auto-routes.md): weapp-vite 提供可选的自动路由能力，扫描主包和分包页面目录，生成路由清单、类型声明与虚拟模块导出。 - [页面 Layout 使用指南](/guide/layouts.md): 详细说明 weapp-vite 的页面 layout 能力，包括 srcRoot/layouts 目录约定、definePageMeta、routeRules 与运行时 setPageLayout 切换。 - [WXML 增强](/guide/wxml.md): WXML 增强，聚焦 guide / wxml 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。 - [WXSS 样式增强与注意点](/guide/wxss.md): Weapp-vite 继承了 Vite 的样式处理能力：支持 .wxss、.css、.scss、.less、.sass、.styl 等格式，并输出为小程序可识别的 WXSS。 - [JSON 配置文件的智能提示](/guide/json-intelli-sense.md): 给 app.json、page.json 等文件加上 $schema 字段后，VS Code、微信开发者工具等编辑器就能提供： - [使用 TS/JS 生成 JSON](/guide/json-enhance.md): 小程序项目里有很多结构相似的 json 配置（页面/组件/App）。Weapp-vite 在兼容原生 json/jsonc 的基础上，允许你用 json.ts / json.js 生成最终配置，让配置也能享受模块化、类型提示和复用能力。 - [分包指南](/guide/subpackage.md): 微信小程序的分包机制在 Weapp-vite 中得到完整支持。本页帮你快速搞清楚两件事： - [共享 Chunk 策略（weapp.chunks）](/guide/chunks.md): weapp.chunks 用于控制 **复用模块的输出位置和形态**，常用于分包优化、避免不必要的 common.js、或减少重复体积。 - [组件库构建（lib 模式）](/guide/lib-mode.md): Weapp-vite 的 **lib 模式** 用于打包小程序组件库或业务模块。它和应用模式的最大区别是： - [静态资源的处理与优化](/guide/image-optimize.md): Weapp-vite 在静态资源方面沿用了 Vite 的约定：import 语句、public 目录、插件生态都可以直接使用。本页聚焦最常见的资源场景，并给出优化建议。 - [微信小程序插件开发](/guide/plugin.md): Weapp-vite 可以在同一个项目中同时维护主应用与插件，只要开启 pluginRoot 就能复用现有的热更新、构建、调试能力。本页将介绍适用场景、目录约定和常见问题，帮助你在几分钟内完成插件开发环境的搭建。 - [Vite 插件识别 weapp-vite 宿主](/guide/vite-plugin-host.md): 在自定义 Vite 插件中判断当前运行环境是否由 weapp-vite 创建，并区分 miniprogram 与 web 两种运行面。 #### 自动导入组件 - [自动引入组件](/guide/auto-import.md): weapp-vite 可以在构建阶段自动扫描并注册组件，让你在 WXML 或 Vue SFC 模板里直接写组件标签，而不必手动维护 usingComponents。 - [自定义 autoImportComponents Resolver](/guide/auto-import-resolver.md): weapp.autoImportComponents.resolvers 用来把 WXML 里的组件标签（例如 ）解析成小程序 usingComponents 需要的 from 路径（例如 @vant/weapp/button）。 #### Prelude 与 Web 注入 - [App Prelude 与 Web Runtime 注入](/guide/app-prelude-web-runtime.md): App Prelude 与 Web Runtime 全局对象注入的功能入口，帮助你区分前置脚本和 Web 风格全局对象注入。 - [App Prelude](/guide/app-prelude.md): 介绍 weapp-vite 的 app.prelude 前置脚本，以及它在小程序入口执行前统一初始化代码的使用方式。 - [Web Runtime 全局对象注入](/guide/web-runtime-globals.md): 介绍 weapp-vite 如何在小程序产物中注入 fetch、XMLHttpRequest、WebSocket 等 Web 风格全局对象。 ### 实验能力 - [面向多平台构建 experimental](/guide/multi-platform.md): Weapp-vite 提供实验性的多端适配能力：在开发/构建命令后追加 --platform （或短写 -p ），即可输出目标平台所需的文件后缀与目录结构。 - [WXS 增强 experimental](/guide/wxs.md): WXS（WeiXin Script）是微信小程序提供的轻量脚本语言，常用于在模板里做一些同步的、简单的逻辑处理。它和 JavaScript 不完全一样，能力也更受限。 - [Web 兼容矩阵 experimental](/guide/web-compat-matrix.md): 本文用于说明 Weapp-vite 在 Web 运行时（@weapp-vite/web）下的能力边界。 状态含义如下： ### 深入 Weapp-vite - [Weapp-vite init 做了什么？](/deep/init.md): Weapp-vite init 是在现有原生项目上接入 Weapp-vite 的最快方式。它会检查当前目录结构、补齐必需的配置文件，然后提示你后续可以手动调整的地方。本节逐步拆解各项改动，方便团队在需要时自行定制或纯手动迁移。 - [依赖分析扫描流程](/deep/scan.md): 当 Weapp-vite 启动构建或监听时，会先确定哪些文件属于入口，然后递归分析它们之间的引用关系。理解这一流程有助于调试“页面没有被构建”“组件样式缺失”等问题。本页以文字和示意图梳理扫描逻辑，方便贡献者和高级用户参考。 - [配置服务内部结构](/deep/config-service.md): 想在 Weapp-vite 中扩展配置加载或贡献新能力？这一页梳理了配置服务的核心文件，帮助你快速定位到对应模块。即便不准备修改源码，也能借此了解 defineConfig 背后的执行流程。 ### 开始使用 - [快速开始](/guide.md): 从零创建或接入 weapp-vite 项目，快速跑通开发、构建、IDE 打开、CLI 透传与后续能力扩展。 - [什么是 Weapp-vite ?](/guide/what-is-weapp-vite.md): Weapp-vite 是一个面向微信小程序的现代构建框架：尽量不改变你写原生小程序的方式（语法、目录结构都能沿用），但把 Vite 生态、TypeScript、CSS 预处理器和更顺滑的开发/构建流程带进来。你仍然写小程序，但开发体验会更… - [CLI 命令参考](/guide/cli.md): weapp-vite CLI 命令参考，覆盖 dev、build、analyze、prepare、mcp、ide logs、generate，以及 screenshot/compare 等 weapp-ide-cli 透传规则。 - [VS Code 扩展](/guide/vscode-extension.md): 为 weapp-vite 项目安装官方 VS Code 扩展，获得命令入口、页面树、生成器、路由维护、配置提示与多端模板增强。 - [AI 协作指南](/guide/ai.md): 面向 weapp-vite 团队的 AI 协作入口，聚焦 Skills、MCP 与 llms.txt 三大章节。 - [AI Skills 使用指南](/guide/skills.md): 按任务场景选择 Weapp-vite 公开 Skills，说明安装方式、触发边界、关联文档和最小验证命令。 - [AI 任务工作流](/guide/ai-workflows.md): 将 Weapp-vite 常见 AI 协作任务拆成可执行流程，覆盖 issue 修复、文档同步、DevTools e2e、SFC 排障和原生迁移。 - [目录结构](/guide/directory-structure.md): Weapp-vite 的目录结构总览页，按 Nuxt 式目录索引组织，左侧目录项为独立路由，右侧为每个目录或文件的详细说明。 - [手动集成 Weapp-vite](/guide/manual-integration.md): 已经有运行中的微信小程序？可以按下面步骤在不依赖脚手架的情况下把 Weapp-vite 接进来。整体思路就三步：补齐配置文件 → 安装依赖 → 调整目录。 ### 原生增强 - [Vue SFC 开发](/guide/vue-sfc.md): 这里是 Vue SFC 开发的入口说明。完整内容已迁移到 Wevu 文档目录：Weapp-vite 负责编译期（.vue → 小程序产物），Wevu 负责运行期（响应式与生命周期）。 - [别名](/guide/alias.md): Weapp-vite 同时支持 **JS/TS 别名** 与 **JSON/JSONC 别名**，让你在脚本和配置文件里都能用同一套路径前缀。本页先给出最常见的配置方式，再补充一些使用建议；更细的字段说明请参考 配置文档 · JSON 配… - [npm 自动构建](/guide/npm.md): Weapp-vite 会尽量帮你把“npm 依赖怎么进小程序”这件事自动化：默认提供 **2 种自动策略**，以及 **1 个手动触发**命令。 - [生成脚手架](/guide/generate.md): Weapp-vite 自带一个生成器，用来一键生成页面/组件/App 的基础文件（页面/组件包含 js/ts、wxml、wxss、json；App 不生成 wxml）。它适合两类情况： - [自动路由（weapp-vite/auto-routes）](/guide/auto-routes.md): weapp-vite 提供可选的自动路由能力，扫描主包和分包页面目录，生成路由清单、类型声明与虚拟模块导出。 - [页面 Layout 使用指南](/guide/layouts.md): 详细说明 weapp-vite 的页面 layout 能力，包括 srcRoot/layouts 目录约定、definePageMeta、routeRules 与运行时 setPageLayout 切换。 - [WXML 增强](/guide/wxml.md): WXML 增强，聚焦 guide / wxml 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。 - [WXSS 样式增强与注意点](/guide/wxss.md): Weapp-vite 继承了 Vite 的样式处理能力：支持 .wxss、.css、.scss、.less、.sass、.styl 等格式，并输出为小程序可识别的 WXSS。 - [JSON 配置文件的智能提示](/guide/json-intelli-sense.md): 给 app.json、page.json 等文件加上 $schema 字段后，VS Code、微信开发者工具等编辑器就能提供： - [使用 TS/JS 生成 JSON](/guide/json-enhance.md): 小程序项目里有很多结构相似的 json 配置（页面/组件/App）。Weapp-vite 在兼容原生 json/jsonc 的基础上，允许你用 json.ts / json.js 生成最终配置，让配置也能享受模块化、类型提示和复用能力。 - [分包指南](/guide/subpackage.md): 微信小程序的分包机制在 Weapp-vite 中得到完整支持。本页帮你快速搞清楚两件事： - [共享 Chunk 策略（weapp.chunks）](/guide/chunks.md): weapp.chunks 用于控制 **复用模块的输出位置和形态**，常用于分包优化、避免不必要的 common.js、或减少重复体积。 - [组件库构建（lib 模式）](/guide/lib-mode.md): Weapp-vite 的 **lib 模式** 用于打包小程序组件库或业务模块。它和应用模式的最大区别是： - [静态资源的处理与优化](/guide/image-optimize.md): Weapp-vite 在静态资源方面沿用了 Vite 的约定：import 语句、public 目录、插件生态都可以直接使用。本页聚焦最常见的资源场景，并给出优化建议。 - [微信小程序插件开发](/guide/plugin.md): Weapp-vite 可以在同一个项目中同时维护主应用与插件，只要开启 pluginRoot 就能复用现有的热更新、构建、调试能力。本页将介绍适用场景、目录约定和常见问题，帮助你在几分钟内完成插件开发环境的搭建。 - [Vite 插件识别 weapp-vite 宿主](/guide/vite-plugin-host.md): 在自定义 Vite 插件中判断当前运行环境是否由 weapp-vite 创建，并区分 miniprogram 与 web 两种运行面。 #### 自动导入组件 - [自动引入组件](/guide/auto-import.md): weapp-vite 可以在构建阶段自动扫描并注册组件，让你在 WXML 或 Vue SFC 模板里直接写组件标签，而不必手动维护 usingComponents。 - [自定义 autoImportComponents Resolver](/guide/auto-import-resolver.md): weapp.autoImportComponents.resolvers 用来把 WXML 里的组件标签（例如 ）解析成小程序 usingComponents 需要的 from 路径（例如 @vant/weapp/button）。 #### Prelude 与 Web 注入 - [App Prelude 与 Web Runtime 注入](/guide/app-prelude-web-runtime.md): App Prelude 与 Web Runtime 全局对象注入的功能入口，帮助你区分前置脚本和 Web 风格全局对象注入。 - [App Prelude](/guide/app-prelude.md): 介绍 weapp-vite 的 app.prelude 前置脚本，以及它在小程序入口执行前统一初始化代码的使用方式。 - [Web Runtime 全局对象注入](/guide/web-runtime-globals.md): 介绍 weapp-vite 如何在小程序产物中注入 fetch、XMLHttpRequest、WebSocket 等 Web 风格全局对象。 ### 实验能力 - [面向多平台构建 experimental](/guide/multi-platform.md): Weapp-vite 提供实验性的多端适配能力：在开发/构建命令后追加 --platform （或短写 -p ），即可输出目标平台所需的文件后缀与目录结构。 - [WXS 增强 experimental](/guide/wxs.md): WXS（WeiXin Script）是微信小程序提供的轻量脚本语言，常用于在模板里做一些同步的、简单的逻辑处理。它和 JavaScript 不完全一样，能力也更受限。 - [Web 兼容矩阵 experimental](/guide/web-compat-matrix.md): 本文用于说明 Weapp-vite 在 Web 运行时（@weapp-vite/web）下的能力边界。 状态含义如下： ### 深入 Weapp-vite - [Weapp-vite init 做了什么？](/deep/init.md): Weapp-vite init 是在现有原生项目上接入 Weapp-vite 的最快方式。它会检查当前目录结构、补齐必需的配置文件，然后提示你后续可以手动调整的地方。本节逐步拆解各项改动，方便团队在需要时自行定制或纯手动迁移。 - [依赖分析扫描流程](/deep/scan.md): 当 Weapp-vite 启动构建或监听时，会先确定哪些文件属于入口，然后递归分析它们之间的引用关系。理解这一流程有助于调试“页面没有被构建”“组件样式缺失”等问题。本页以文字和示意图梳理扫描逻辑，方便贡献者和高级用户参考。 - [配置服务内部结构](/deep/config-service.md): 想在 Weapp-vite 中扩展配置加载或贡献新能力？这一页梳理了配置服务的核心文件，帮助你快速定位到对应模块。即便不准备修改源码，也能借此了解 defineConfig 背后的执行流程。 ### 开始使用 - [快速开始](/guide.md): 从零创建或接入 weapp-vite 项目，快速跑通开发、构建、IDE 打开、CLI 透传与后续能力扩展。 - [什么是 Weapp-vite ?](/guide/what-is-weapp-vite.md): Weapp-vite 是一个面向微信小程序的现代构建框架：尽量不改变你写原生小程序的方式（语法、目录结构都能沿用），但把 Vite 生态、TypeScript、CSS 预处理器和更顺滑的开发/构建流程带进来。你仍然写小程序，但开发体验会更… - [CLI 命令参考](/guide/cli.md): weapp-vite CLI 命令参考，覆盖 dev、build、analyze、prepare、mcp、ide logs、generate，以及 screenshot/compare 等 weapp-ide-cli 透传规则。 - [VS Code 扩展](/guide/vscode-extension.md): 为 weapp-vite 项目安装官方 VS Code 扩展，获得命令入口、页面树、生成器、路由维护、配置提示与多端模板增强。 - [AI 协作指南](/guide/ai.md): 面向 weapp-vite 团队的 AI 协作入口，聚焦 Skills、MCP 与 llms.txt 三大章节。 - [AI Skills 使用指南](/guide/skills.md): 按任务场景选择 Weapp-vite 公开 Skills，说明安装方式、触发边界、关联文档和最小验证命令。 - [AI 任务工作流](/guide/ai-workflows.md): 将 Weapp-vite 常见 AI 协作任务拆成可执行流程，覆盖 issue 修复、文档同步、DevTools e2e、SFC 排障和原生迁移。 - [目录结构](/guide/directory-structure.md): Weapp-vite 的目录结构总览页，按 Nuxt 式目录索引组织，左侧目录项为独立路由，右侧为每个目录或文件的详细说明。 - [手动集成 Weapp-vite](/guide/manual-integration.md): 已经有运行中的微信小程序？可以按下面步骤在不依赖脚手架的情况下把 Weapp-vite 接进来。整体思路就三步：补齐配置文件 → 安装依赖 → 调整目录。 ### 原生增强 - [Vue SFC 开发](/guide/vue-sfc.md): 这里是 Vue SFC 开发的入口说明。完整内容已迁移到 Wevu 文档目录：Weapp-vite 负责编译期（.vue → 小程序产物），Wevu 负责运行期（响应式与生命周期）。 - [别名](/guide/alias.md): Weapp-vite 同时支持 **JS/TS 别名** 与 **JSON/JSONC 别名**，让你在脚本和配置文件里都能用同一套路径前缀。本页先给出最常见的配置方式，再补充一些使用建议；更细的字段说明请参考 配置文档 · JSON 配… - [npm 自动构建](/guide/npm.md): Weapp-vite 会尽量帮你把“npm 依赖怎么进小程序”这件事自动化：默认提供 **2 种自动策略**，以及 **1 个手动触发**命令。 - [生成脚手架](/guide/generate.md): Weapp-vite 自带一个生成器，用来一键生成页面/组件/App 的基础文件（页面/组件包含 js/ts、wxml、wxss、json；App 不生成 wxml）。它适合两类情况： - [自动路由（weapp-vite/auto-routes）](/guide/auto-routes.md): weapp-vite 提供可选的自动路由能力，扫描主包和分包页面目录，生成路由清单、类型声明与虚拟模块导出。 - [页面 Layout 使用指南](/guide/layouts.md): 详细说明 weapp-vite 的页面 layout 能力，包括 srcRoot/layouts 目录约定、definePageMeta、routeRules 与运行时 setPageLayout 切换。 - [WXML 增强](/guide/wxml.md): WXML 增强，聚焦 guide / wxml 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。 - [WXSS 样式增强与注意点](/guide/wxss.md): Weapp-vite 继承了 Vite 的样式处理能力：支持 .wxss、.css、.scss、.less、.sass、.styl 等格式，并输出为小程序可识别的 WXSS。 - [JSON 配置文件的智能提示](/guide/json-intelli-sense.md): 给 app.json、page.json 等文件加上 $schema 字段后，VS Code、微信开发者工具等编辑器就能提供： - [使用 TS/JS 生成 JSON](/guide/json-enhance.md): 小程序项目里有很多结构相似的 json 配置（页面/组件/App）。Weapp-vite 在兼容原生 json/jsonc 的基础上，允许你用 json.ts / json.js 生成最终配置，让配置也能享受模块化、类型提示和复用能力。 - [分包指南](/guide/subpackage.md): 微信小程序的分包机制在 Weapp-vite 中得到完整支持。本页帮你快速搞清楚两件事： - [共享 Chunk 策略（weapp.chunks）](/guide/chunks.md): weapp.chunks 用于控制 **复用模块的输出位置和形态**，常用于分包优化、避免不必要的 common.js、或减少重复体积。 - [组件库构建（lib 模式）](/guide/lib-mode.md): Weapp-vite 的 **lib 模式** 用于打包小程序组件库或业务模块。它和应用模式的最大区别是： - [静态资源的处理与优化](/guide/image-optimize.md): Weapp-vite 在静态资源方面沿用了 Vite 的约定：import 语句、public 目录、插件生态都可以直接使用。本页聚焦最常见的资源场景，并给出优化建议。 - [微信小程序插件开发](/guide/plugin.md): Weapp-vite 可以在同一个项目中同时维护主应用与插件，只要开启 pluginRoot 就能复用现有的热更新、构建、调试能力。本页将介绍适用场景、目录约定和常见问题，帮助你在几分钟内完成插件开发环境的搭建。 - [Vite 插件识别 weapp-vite 宿主](/guide/vite-plugin-host.md): 在自定义 Vite 插件中判断当前运行环境是否由 weapp-vite 创建，并区分 miniprogram 与 web 两种运行面。 #### 自动导入组件 - [自动引入组件](/guide/auto-import.md): weapp-vite 可以在构建阶段自动扫描并注册组件，让你在 WXML 或 Vue SFC 模板里直接写组件标签，而不必手动维护 usingComponents。 - [自定义 autoImportComponents Resolver](/guide/auto-import-resolver.md): weapp.autoImportComponents.resolvers 用来把 WXML 里的组件标签（例如 ）解析成小程序 usingComponents 需要的 from 路径（例如 @vant/weapp/button）。 #### Prelude 与 Web 注入 - [App Prelude 与 Web Runtime 注入](/guide/app-prelude-web-runtime.md): App Prelude 与 Web Runtime 全局对象注入的功能入口，帮助你区分前置脚本和 Web 风格全局对象注入。 - [App Prelude](/guide/app-prelude.md): 介绍 weapp-vite 的 app.prelude 前置脚本，以及它在小程序入口执行前统一初始化代码的使用方式。 - [Web Runtime 全局对象注入](/guide/web-runtime-globals.md): 介绍 weapp-vite 如何在小程序产物中注入 fetch、XMLHttpRequest、WebSocket 等 Web 风格全局对象。 ### 实验能力 - [面向多平台构建 experimental](/guide/multi-platform.md): Weapp-vite 提供实验性的多端适配能力：在开发/构建命令后追加 --platform （或短写 -p ），即可输出目标平台所需的文件后缀与目录结构。 - [WXS 增强 experimental](/guide/wxs.md): WXS（WeiXin Script）是微信小程序提供的轻量脚本语言，常用于在模板里做一些同步的、简单的逻辑处理。它和 JavaScript 不完全一样，能力也更受限。 - [Web 兼容矩阵 experimental](/guide/web-compat-matrix.md): 本文用于说明 Weapp-vite 在 Web 运行时（@weapp-vite/web）下的能力边界。 状态含义如下： ### 深入 Weapp-vite - [Weapp-vite init 做了什么？](/deep/init.md): Weapp-vite init 是在现有原生项目上接入 Weapp-vite 的最快方式。它会检查当前目录结构、补齐必需的配置文件，然后提示你后续可以手动调整的地方。本节逐步拆解各项改动，方便团队在需要时自行定制或纯手动迁移。 - [依赖分析扫描流程](/deep/scan.md): 当 Weapp-vite 启动构建或监听时，会先确定哪些文件属于入口，然后递归分析它们之间的引用关系。理解这一流程有助于调试“页面没有被构建”“组件样式缺失”等问题。本页以文字和示意图梳理扫描逻辑，方便贡献者和高级用户参考。 - [配置服务内部结构](/deep/config-service.md): 想在 Weapp-vite 中扩展配置加载或贡献新能力？这一页梳理了配置服务的核心文件，帮助你快速定位到对应模块。即便不准备修改源码，也能借此了解 defineConfig 背后的执行流程。 ### 社区 - [优秀案例展示](/community/showcase.md): 优秀案例展示，聚焦 community / showcase 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。 - [加入技术交流群](/community/group.md): 如果你在使用中遇到什么问题，也欢迎你进入交流群进行提问。提问时请尽量携带最小复现案例，我们会更快定位问题。 ### 生态集成 - [Tailwindcss 集成](/integration/tailwindcss.md): 如果你是新项目，直接用官方模板创建即可，模板已集成 Tailwind CSS： - [Vue-mini 集成](/integration/vue-mini.md): Vue Mini 是一个基于 Vue 3 的小程序框架，你可以用 Vue 3 的响应式和组合式 API 来开发小程序。 - [tdesign-miniprogram 集成](/integration/tdesign.md): 在 Weapp-vite 项目里接入 tdesign-miniprogram 的整体思路很简单： - [Vant Weapp 集成](/integration/vant.md): Vant Weapp 集成，聚焦 integration / vant 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。 - [miniprogram-computed 集成](/integration/miniprogram-computed.md): miniprogram-computed 的用法基本和官方一致。需要注意的是：为了确保构建产物里依赖齐全，建议把它的运行时依赖也显式安装到项目里（避免构建时被裁剪/遗漏）。 ### 社区 - [优秀案例展示](/community/showcase.md): 优秀案例展示，聚焦 community / showcase 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。 - [加入技术交流群](/community/group.md): 如果你在使用中遇到什么问题，也欢迎你进入交流群进行提问。提问时请尽量携带最小复现案例，我们会更快定位问题。 ### 生态集成 - [Tailwindcss 集成](/integration/tailwindcss.md): 如果你是新项目，直接用官方模板创建即可，模板已集成 Tailwind CSS： - [Vue-mini 集成](/integration/vue-mini.md): Vue Mini 是一个基于 Vue 3 的小程序框架，你可以用 Vue 3 的响应式和组合式 API 来开发小程序。 - [tdesign-miniprogram 集成](/integration/tdesign.md): 在 Weapp-vite 项目里接入 tdesign-miniprogram 的整体思路很简单： - [Vant Weapp 集成](/integration/vant.md): Vant Weapp 集成，聚焦 integration / vant 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。 - [miniprogram-computed 集成](/integration/miniprogram-computed.md): miniprogram-computed 的用法基本和官方一致。需要注意的是：为了确保构建产物里依赖齐全，建议把它的运行时依赖也显式安装到项目里（避免构建时被裁剪/遗漏）。 ### 最新文章 - [Weapp-vite：原生模式之外，多一种 Vue 选择](/blog/release6.md): 还记得在 Weapp-vite 4.0 的发布文章里，我写过这样的话： - [重走 Vue 长征路 Weapp-vite：编译链路与 Wevu 运行时原理拆解](/blog/release6-principles.md): 这篇文档不是功能清单，而是 Weapp-vite@6 在实现 Vue SFC 支持时的一份技术复盘，重点记录编译链路、运行时更新路径和关键取舍。 - [Weapp-vite - 微信小程序工具链的另一种选择](/blog/release4.md): Weapp-vite 是由 笔者 icebreaker 开发的一个基于 vite 的现代化微信小程序开发工具链。我给它设定的目标初心是: 为小程序开发者带来笑容。 - [这段时间 Weapp-vite 的功能更新与优化](/blog/release1_7.md): 这段时间 Weapp-vite 的功能更新与优化，聚焦 blog / release1_7 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。 - [Weapp-vite 发布：重塑小程序开发体验！](/blog/announce.md): Weapp-vite 发布：重塑小程序开发体验！，聚焦 blog / announce 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。 ### 配置总览 - [配置概览](/config.md): weapp-vite 基于 Vite 配置模型扩展 weapp 字段，统一管理小程序构建、自动路由、自动导入、MCP、Web 运行时与库模式等能力。 ### 项目基础 - [基础目录与资源收集](/config/paths.md): 说明 weapp-vite 如何确定源码根目录、插件目录和资源复制范围，以及这些配置与 Vite root/publicDir 的边界。 - [构建输出与兼容](/config/build-and-output.md): 解释 weapp-vite 的平台、输出目录、JS 输出格式与兼容策略，以及这些配置与 Vite build 的边界。 - [TypeScript 支持文件](/config/typescript.md): weapp-vite 会生成 .weapp-vite 下的托管 tsconfig 与类型文件，用于稳定承接自动路由、自动导入组件、layout 和编辑器提示。 - [Analyze 报告配置](/config/analyze.md): 说明 weapp.analyze 的包体预算、历史快照，以及 wv analyze 的 Markdown、PR 摘要和预算检查工作流。 ### 应用结构与路由 - [Route Rules 与 Layout](/config/route-rules.md): 使用 weapp.routeRules 为页面批量声明默认 layout，并结合 srcRoot/layouts 与 definePageMeta 实现页面外壳复用。 - [分包配置](/config/subpackages.md): weapp-vite 会读取 app.json.subPackages 生成分包产物；weapp.subPackages 则提供独立分包、分包级内联配置、自动导入覆盖与共享样式等增强能力。 - [Worker 配置](/config/worker.md): 当 app.json 配置了 workers 目录，Weapp-vite 可以帮助编译 Worker 入口脚本。 ### Vue / Wevu 与模板编译 - [JSON 配置](/config/json.md): Weapp-vite 支持原生 json/jsonc，并提供 **JSON 别名** 与 **JSON 合并策略**，方便在 app.json / page.json / component.json 中复用配置。 - [JS 配置](/config/js.md): Weapp-vite 默认使用 Vite 8 原生的 resolve.tsconfigPaths 读取 tsconfig.json/jsconfig.json 的 paths/baseUrl，并在需要高级选项时兼容 vite-tsconfig-paths。 - [Vue SFC 配置](/config/vue.md): Weapp-vite 内置 Vue SFC（.vue → WXML/WXSS/JS/JSON）编译链路。这里聚焦编译期可配置项。 - [Wevu 编译期配置](/config/wevu.md): 说明 weapp.wevu.defaults、preset 与 autoSetDataPick 的作用、默认行为和适用场景。 - [开发态 HMR 配置](/config/hmr.md): 说明 weapp.hmr.runtime、sharedChunks、touchAppWxss、logLevel 与 profileJson 的默认行为、适用场景和取舍。 - [WXML 配置](/config/wxml.md): Weapp-vite 会扫描 WXML 以完成组件自动导入、WXS 依赖分析与模板产物输出。本页说明 weapp.wxml 的配置项与当前生效范围。 - [WXS 配置 experimental](/config/wxs.md): Weapp-vite 会对 .wxs/.sjs（以及 .wxs.ts/.wxs.js）进行编译输出，并在 Vue SFC 的 class/style 运行时中按需使用 WXS。 - [共享配置](/config/shared.md): weapp-vite 的共享增强配置，包含自动路由、调试钩子、日志、forwardConsole、injectWeapi 与 MCP 等能力。 ### Prelude 与 Web 注入 - [App Prelude 配置](/config/app-prelude.md): weapp.appPrelude 的配置说明，覆盖 app.prelude 前置脚本开关、注入模式与产物行为。 - [Web Runtime 全局对象注入配置](/config/web-runtime-globals.md): weapp.appPrelude.webRuntime 的配置说明，覆盖 Web Runtime 全局对象注入、目标对象、依赖匹配与网络默认参数。 ### 组件、依赖与产物 - [自动导入组件配置](/config/auto-import-components.md): Weapp-vite 会在构建阶段扫描 WXML 组件标签并自动补齐 usingComponents，免去手写 JSON 的负担。支持本地组件与第三方库 Resolver（如 Vant/TDesign）。 - [共享 Chunk 配置](/config/chunks.md): weapp.chunks 用于控制共享模块在主包、普通分包中的输出位置与输出形态。这是分包优化里最关键的一组配置。 - [npm 配置](/config/npm.md): weapp-vite 会把运行时依赖构建到小程序 npm 目录，并允许你按主包、插件、分包精细控制依赖落位、缓存与底层构建参数。 - [库模式配置](/config/lib.md): weapp-vite 的 lib 模式用于构建小程序组件库或业务模块库，支持多入口、路径保持、组件 JSON 生成与 DTS 输出。 - [生成脚手架配置](/config/generate.md): Weapp-vite generate 用于快速生成页面、组件和 App 基础文件。本页列出 weapp.generate 的字段，方便你把生成目录、文件名、后缀和模板内容对齐到团队习惯。**这些配置仅影响 CLI 生成器，不影响构建流程… ### 实验能力 - [Web 运行时配置 experimental](/config/web.md): weapp-vite 可选集成浏览器端运行时 @weapp-vite/web，用于预览、兼容验证、截图联调与 AI 调试。 ### @wevu/api - [@wevu/api](/packages/weapi.md): @wevu/api 独立文档入口，按总览、全量目录、兼容矩阵与差异说明组织。 - [wpi 概览](/packages/weapi/overview.md): wpi 是 @wevu/api 提供的统一跨端 API 对象，支持 Promise、回调、能力探测与显式平台注入。 - [@wevu/api 兼容总览](/packages/weapi/compat-overview.md): @wevu/api 三端 API 兼容报告总览，覆盖覆盖率、对齐结论与核心差异映射。 - [API 全量清单](/packages/weapi/wx-method-list.md): @wevu/api 基于微信命名体系的全量 API 目录，包含每个 API 的用途、示例与微信开放文档搜索入口。 - [支付宝兼容矩阵](/packages/weapi/alipay-compat-matrix.md): @wevu/api 按微信命名调用时的支付宝兼容矩阵。 - [抖音兼容矩阵](/packages/weapi/douyin-compat-matrix.md): @wevu/api 按微信命名调用时的抖音兼容矩阵。 - [兼容差异说明](/packages/weapi/gap-notes.md): @wevu/api 兼容报告中的特殊命名、类型来源差异与 gap 说明。 - [平台独有 API 清单](/packages/weapi/platform-only-methods.md): @wevu/api 三端类型来源中，相对微信命名体系的支付宝/抖音独有 API 清单。 #### API 全量清单 - [API 全量清单 · 基础](/packages/weapi/wx-method-list/base.md): @wevu/api 的 API 全量清单页，聚焦基础能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · 路由](/packages/weapi/wx-method-list/route.md): @wevu/api 的 API 全量清单页，聚焦路由能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · 跳转](/packages/weapi/wx-method-list/navigate.md): @wevu/api 的 API 全量清单页，聚焦跳转能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · 聊天工具](/packages/weapi/wx-method-list/chattool.md): @wevu/api 的 API 全量清单页，聚焦聊天工具能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · 转发](/packages/weapi/wx-method-list/share.md): @wevu/api 的 API 全量清单页，聚焦转发能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · 界面](/packages/weapi/wx-method-list/ui.md): @wevu/api 的 API 全量清单页，聚焦界面能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · 网络](/packages/weapi/wx-method-list/network.md): @wevu/api 的 API 全量清单页，聚焦网络能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · 支付](/packages/weapi/wx-method-list/payment.md): @wevu/api 的 API 全量清单页，聚焦支付能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · 数据缓存](/packages/weapi/wx-method-list/storage.md): @wevu/api 的 API 全量清单页，聚焦数据缓存能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · 数据分析](/packages/weapi/wx-method-list/data-analysis.md): @wevu/api 的 API 全量清单页，聚焦数据分析能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · 画布](/packages/weapi/wx-method-list/canvas.md): @wevu/api 的 API 全量清单页，聚焦画布能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · 媒体](/packages/weapi/wx-method-list/media.md): @wevu/api 的 API 全量清单页，聚焦媒体能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · 位置](/packages/weapi/wx-method-list/location.md): @wevu/api 的 API 全量清单页，聚焦位置能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · 文件](/packages/weapi/wx-method-list/file.md): @wevu/api 的 API 全量清单页，聚焦文件能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · 开放接口](/packages/weapi/wx-method-list/open-api.md): @wevu/api 的 API 全量清单页，聚焦开放接口能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · 设备](/packages/weapi/wx-method-list/device.md): @wevu/api 的 API 全量清单页，聚焦设备能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · AI](/packages/weapi/wx-method-list/ai.md): @wevu/api 的 API 全量清单页，聚焦AI能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · Worker](/packages/weapi/wx-method-list/worker.md): @wevu/api 的 API 全量清单页，聚焦Worker能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · WXML](/packages/weapi/wx-method-list/wxml.md): @wevu/api 的 API 全量清单页，聚焦WXML能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · 第三方平台](/packages/weapi/wx-method-list/ext.md): @wevu/api 的 API 全量清单页，聚焦第三方平台能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · 广告](/packages/weapi/wx-method-list/ad.md): @wevu/api 的 API 全量清单页，聚焦广告能力分类，便于快速检索微信小程序相关接口与组件 API。 - [API 全量清单 · XR-FRAME](/packages/weapi/wx-method-list/xr-frame.md): @wevu/api 的 API 全量清单页，聚焦XR-FRAME能力分类，便于快速检索微信小程序相关接口与组件 API。 #### 支付宝兼容矩阵 - [支付宝兼容矩阵 · 基础](/packages/weapi/alipay-compat-matrix/base.md): @wevu/api 的支付宝兼容矩阵页，聚焦基础能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · 路由](/packages/weapi/alipay-compat-matrix/route.md): @wevu/api 的支付宝兼容矩阵页，聚焦路由能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · 跳转](/packages/weapi/alipay-compat-matrix/navigate.md): @wevu/api 的支付宝兼容矩阵页，聚焦跳转能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · 聊天工具](/packages/weapi/alipay-compat-matrix/chattool.md): @wevu/api 的支付宝兼容矩阵页，聚焦聊天工具能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · 转发](/packages/weapi/alipay-compat-matrix/share.md): @wevu/api 的支付宝兼容矩阵页，聚焦转发能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · 界面](/packages/weapi/alipay-compat-matrix/ui.md): @wevu/api 的支付宝兼容矩阵页，聚焦界面能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · 网络](/packages/weapi/alipay-compat-matrix/network.md): @wevu/api 的支付宝兼容矩阵页，聚焦网络能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · 支付](/packages/weapi/alipay-compat-matrix/payment.md): @wevu/api 的支付宝兼容矩阵页，聚焦支付能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · 数据缓存](/packages/weapi/alipay-compat-matrix/storage.md): @wevu/api 的支付宝兼容矩阵页，聚焦数据缓存能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · 数据分析](/packages/weapi/alipay-compat-matrix/data-analysis.md): @wevu/api 的支付宝兼容矩阵页，聚焦数据分析能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · 画布](/packages/weapi/alipay-compat-matrix/canvas.md): @wevu/api 的支付宝兼容矩阵页，聚焦画布能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · 媒体](/packages/weapi/alipay-compat-matrix/media.md): @wevu/api 的支付宝兼容矩阵页，聚焦媒体能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · 位置](/packages/weapi/alipay-compat-matrix/location.md): @wevu/api 的支付宝兼容矩阵页，聚焦位置能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · 文件](/packages/weapi/alipay-compat-matrix/file.md): @wevu/api 的支付宝兼容矩阵页，聚焦文件能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · 开放接口](/packages/weapi/alipay-compat-matrix/open-api.md): @wevu/api 的支付宝兼容矩阵页，聚焦开放接口能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · 设备](/packages/weapi/alipay-compat-matrix/device.md): @wevu/api 的支付宝兼容矩阵页，聚焦设备能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · AI](/packages/weapi/alipay-compat-matrix/ai.md): @wevu/api 的支付宝兼容矩阵页，聚焦AI能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · Worker](/packages/weapi/alipay-compat-matrix/worker.md): @wevu/api 的支付宝兼容矩阵页，聚焦Worker能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · WXML](/packages/weapi/alipay-compat-matrix/wxml.md): @wevu/api 的支付宝兼容矩阵页，聚焦WXML能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · 第三方平台](/packages/weapi/alipay-compat-matrix/ext.md): @wevu/api 的支付宝兼容矩阵页，聚焦第三方平台能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · 广告](/packages/weapi/alipay-compat-matrix/ad.md): @wevu/api 的支付宝兼容矩阵页，聚焦广告能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 - [支付宝兼容矩阵 · XR-FRAME](/packages/weapi/alipay-compat-matrix/xr-frame.md): @wevu/api 的支付宝兼容矩阵页，聚焦XR-FRAME能力分类，帮助快速查看支付宝小程序与微信 API 的兼容情况。 #### 抖音兼容矩阵 - [抖音兼容矩阵 · 基础](/packages/weapi/douyin-compat-matrix/base.md): @wevu/api 的抖音兼容矩阵页，聚焦基础能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · 路由](/packages/weapi/douyin-compat-matrix/route.md): @wevu/api 的抖音兼容矩阵页，聚焦路由能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · 跳转](/packages/weapi/douyin-compat-matrix/navigate.md): @wevu/api 的抖音兼容矩阵页，聚焦跳转能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · 聊天工具](/packages/weapi/douyin-compat-matrix/chattool.md): @wevu/api 的抖音兼容矩阵页，聚焦聊天工具能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · 转发](/packages/weapi/douyin-compat-matrix/share.md): @wevu/api 的抖音兼容矩阵页，聚焦转发能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · 界面](/packages/weapi/douyin-compat-matrix/ui.md): @wevu/api 的抖音兼容矩阵页，聚焦界面能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · 网络](/packages/weapi/douyin-compat-matrix/network.md): @wevu/api 的抖音兼容矩阵页，聚焦网络能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · 支付](/packages/weapi/douyin-compat-matrix/payment.md): @wevu/api 的抖音兼容矩阵页，聚焦支付能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · 数据缓存](/packages/weapi/douyin-compat-matrix/storage.md): @wevu/api 的抖音兼容矩阵页，聚焦数据缓存能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · 数据分析](/packages/weapi/douyin-compat-matrix/data-analysis.md): @wevu/api 的抖音兼容矩阵页，聚焦数据分析能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · 画布](/packages/weapi/douyin-compat-matrix/canvas.md): @wevu/api 的抖音兼容矩阵页，聚焦画布能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · 媒体](/packages/weapi/douyin-compat-matrix/media.md): @wevu/api 的抖音兼容矩阵页，聚焦媒体能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · 位置](/packages/weapi/douyin-compat-matrix/location.md): @wevu/api 的抖音兼容矩阵页，聚焦位置能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · 文件](/packages/weapi/douyin-compat-matrix/file.md): @wevu/api 的抖音兼容矩阵页，聚焦文件能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · 开放接口](/packages/weapi/douyin-compat-matrix/open-api.md): @wevu/api 的抖音兼容矩阵页，聚焦开放接口能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · 设备](/packages/weapi/douyin-compat-matrix/device.md): @wevu/api 的抖音兼容矩阵页，聚焦设备能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · AI](/packages/weapi/douyin-compat-matrix/ai.md): @wevu/api 的抖音兼容矩阵页，聚焦AI能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · Worker](/packages/weapi/douyin-compat-matrix/worker.md): @wevu/api 的抖音兼容矩阵页，聚焦Worker能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · WXML](/packages/weapi/douyin-compat-matrix/wxml.md): @wevu/api 的抖音兼容矩阵页，聚焦WXML能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · 第三方平台](/packages/weapi/douyin-compat-matrix/ext.md): @wevu/api 的抖音兼容矩阵页，聚焦第三方平台能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · 广告](/packages/weapi/douyin-compat-matrix/ad.md): @wevu/api 的抖音兼容矩阵页，聚焦广告能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 - [抖音兼容矩阵 · XR-FRAME](/packages/weapi/douyin-compat-matrix/xr-frame.md): @wevu/api 的抖音兼容矩阵页，聚焦XR-FRAME能力分类，帮助快速查看抖音小程序与微信 API 的兼容情况。 ### 总览 - [周边包总览](/packages.md): weapp-vite 不只是一个构建器，packages 下还提供脚手架、IDE CLI、MCP、跨端 API、Web 运行时、Volar 与编译底座等能力。 ### 工程工具 - [create-weapp-vite](/packages/create-weapp-vite.md): create-weapp-vite 是官方脚手架，用于快速创建小程序工程，并在模板中对齐 Weapp-vite / Wevu 的版本组合。 - [weapp-ide-cli](/packages/weapp-ide-cli.md): weapp-ide-cli 是微信开发者工具 CLI 的增强封装，提供命令透传、automator 子命令、配置管理与多语言输出。 - [rolldown-require 使用指南](/packages/rolldown-require/index.zh.md): rolldown-require 是基于 rolldown 的「打包再加载」工具，帮助 CLI 或 Node 脚本安全地执行任意格式的配置文件（ts / mjs / cjs / JSX 等）。API 与 bundle-require 保持… - [vite-plugin-performance](/packages/vite-plugin-performance.md): vite-plugin-performance 用于包装一个或多个 Vite 插件，并统计每个生命周期 Hook 的执行耗时。 ### 运行时与编译 - [@wevu/compiler](/packages/wevu-compiler.md): @wevu/compiler 是 Wevu 的编译能力底座，提供 Vue SFC 与小程序模板的解析、转换和输出能力。 - [@weapp-vite/web](/packages/web.md): @weapp-vite/web 是实验性的 H5 运行时与 Vite 插件，用于把小程序模板能力映射到浏览器环境做验证。 - [@weapp-vite/volar](/packages/volar.md): @weapp-vite/volar 为 Weapp-vite 项目提供 Volar 语言服务能力，重点增强 配置块的补全与校验。 #### @wevu/api（跨端 API） - [@wevu/api](/packages/weapi.md): @wevu/api 独立文档入口，按总览、全量目录、兼容矩阵与差异说明组织。 - [@wevu/api 兼容总览](/packages/weapi/compat-overview.md): @wevu/api 三端 API 兼容报告总览，覆盖覆盖率、对齐结论与核心差异映射。 - [API 全量清单](/packages/weapi/wx-method-list.md): @wevu/api 基于微信命名体系的全量 API 目录，包含每个 API 的用途、示例与微信开放文档搜索入口。 - [支付宝兼容矩阵](/packages/weapi/alipay-compat-matrix.md): @wevu/api 按微信命名调用时的支付宝兼容矩阵。 - [抖音兼容矩阵](/packages/weapi/douyin-compat-matrix.md): @wevu/api 按微信命名调用时的抖音兼容矩阵。 - [兼容差异说明](/packages/weapi/gap-notes.md): @wevu/api 兼容报告中的特殊命名、类型来源差异与 gap 说明。 - [平台独有 API 清单](/packages/weapi/platform-only-methods.md): @wevu/api 三端类型来源中，相对微信命名体系的支付宝/抖音独有 API 清单。 ### AI 与实验 - [@weapp-vite/mcp](/packages/mcp.md): @weapp-vite/mcp 是 weapp-vite 官方 MCP 服务实现，面向 AI 助手提供源码检索、命令执行与文档资源能力。 ### rolldown-require (EN) - [rolldown-require Guide](/packages/rolldown-require.md): rolldown-require bundles and then loads config files of any flavor (TS / MJS / CJS / JSX, etc.) using rolldown, so CLI … - [API & options](/packages/rolldown-require/options.md): rolldown-require exposes three APIs: bundleRequire, bundleFile, and loadFromBundledFile. Prefer the one-stop bundleRequ… - [Loading flow & cache](/packages/rolldown-require/cache.md): This page outlines how bundleRequire bundles, writes, and loads under the hood, plus practical cache settings. ### rolldown-require (中文) - [rolldown-require 使用指南](/packages/rolldown-require/index.zh.md): rolldown-require 是基于 rolldown 的「打包再加载」工具，帮助 CLI 或 Node 脚本安全地执行任意格式的配置文件（ts / mjs / cjs / JSX 等）。API 与 bundle-require 保持… - [API 与选项说明](/packages/rolldown-require/options.zh.md): rolldown-require 暴露了 bundleRequire / bundleFile / loadFromBundledFile 三个 API，但推荐优先使用一站式的 bundleRequire。它会完成入口解析、rolldow… - [加载流程与缓存策略](/packages/rolldown-require/cache.zh.md): 本文梳理 bundleRequire 在内部如何打包、落盘与加载，并介绍缓存相关的实用配置。 ### API 首页 - [Wevu API 速查](/wevu/api.md): Wevu API 完整速查页，按 Vue 迁移兼容性、能力类型与运行作用域筛选公开能力。 ### Global API - [Core API](/wevu/api/core.md): 本页聚焦 Wevu 的入口能力、组件定义、script setup 宏与模板工具，采用逐 API 讲解结构。 - [Options API](/wevu/api/options-api.md): Wevu 支持的 Vue 风格与小程序原生 Options API 清单，以及迁移时需要注意的语义差异。 ### Composition API - [Reactivity API](/wevu/api/reactivity.md): 本页覆盖 Wevu 响应式层的全部公开函数，包括状态创建、监听副作用、工具函数与调度能力。 - [Lifecycle API](/wevu/api/lifecycle.md): 本页仅覆盖 wevu 实际导出的生命周期 Hook（源码：runtime/hooks.ts），并补充与小程序 lifetimes/pageLifetimes 的映射说明。 - [Setup Context API](/wevu/api/setup-context.md): 本页严格对应 wevu 源码中的 setup 上下文相关导出（runtime/hooks.ts、runtime/provide.ts、runtime/register.ts、runtime/vueCompat.ts）。 ### Runtime API - [Store API](/wevu/api/store.md): 本页覆盖 wevu/store 的入口函数、Store 实例 API、Manager、Options Store 配置及公开类型。 - [Runtime Bridge API](/wevu/api/runtime-bridge.md): 本页仅展示面向业务与配置层的 Wevu 运行时 API。框架内部桥接函数不会在文档中展开。 ### Type API - [Wevu Router API](/wevu/api/router.md): wevu/router 完整 API 参考，覆盖入口函数、Router 实例、导航守卫、动态路由和公开类型。 - [Wevu Router 类型](/wevu/api/router-types.md): wevu/router 的公开 TypeScript 类型，覆盖位置、参数、守卫、失败、路由记录和小程序宿主 Router。 - [Type Reference](/wevu/api/types.md): 本页仅保留业务开发最常用的公开类型。内部运行时类型不会在文档中展开。 ### API 首页 - [Wevu API 速查](/wevu/api.md): Wevu API 完整速查页，按 Vue 迁移兼容性、能力类型与运行作用域筛选公开能力。 ### Global API - [Core API](/wevu/api/core.md): 本页聚焦 Wevu 的入口能力、组件定义、script setup 宏与模板工具，采用逐 API 讲解结构。 - [Options API](/wevu/api/options-api.md): Wevu 支持的 Vue 风格与小程序原生 Options API 清单，以及迁移时需要注意的语义差异。 ### Composition API - [Reactivity API](/wevu/api/reactivity.md): 本页覆盖 Wevu 响应式层的全部公开函数，包括状态创建、监听副作用、工具函数与调度能力。 - [Lifecycle API](/wevu/api/lifecycle.md): 本页仅覆盖 wevu 实际导出的生命周期 Hook（源码：runtime/hooks.ts），并补充与小程序 lifetimes/pageLifetimes 的映射说明。 - [Setup Context API](/wevu/api/setup-context.md): 本页严格对应 wevu 源码中的 setup 上下文相关导出（runtime/hooks.ts、runtime/provide.ts、runtime/register.ts、runtime/vueCompat.ts）。 ### Runtime API - [Store API](/wevu/api/store.md): 本页覆盖 wevu/store 的入口函数、Store 实例 API、Manager、Options Store 配置及公开类型。 - [Runtime Bridge API](/wevu/api/runtime-bridge.md): 本页仅展示面向业务与配置层的 Wevu 运行时 API。框架内部桥接函数不会在文档中展开。 ### Type API - [Wevu Router API](/wevu/api/router.md): wevu/router 完整 API 参考，覆盖入口函数、Router 实例、导航守卫、动态路由和公开类型。 - [Wevu Router 类型](/wevu/api/router-types.md): wevu/router 的公开 TypeScript 类型，覆盖位置、参数、守卫、失败、路由记录和小程序宿主 Router。 - [Type Reference](/wevu/api/types.md): 本页仅保留业务开发最常用的公开类型。内部运行时类型不会在文档中展开。 ### Wevu - [Wevu 概览](/wevu.md): Wevu 是面向小程序的轻量运行时，为 weapp-vite 的 Vue SFC 与组合式开发提供响应式、生命周期、Store 与最小化 setData 更新能力。 - [快速上手](/wevu/quick-start.md): 这一页只做一件事：帮你最快把 Wevu 跑起来。按“装包 -> 写一个页面/组件 ->（可选）接入 Store”走一遍即可。示例以 Weapp-vite + Vue SFC 为主；如果你不使用 SFC，也可以直接参考运行时 API 的部分。 - [运行时与生命周期](/wevu/runtime.md): 介绍 Wevu 运行时的桥接机制、生命周期映射与 setData 更新策略，并给出定位“未触发/未更新”问题的实操方法。 - [defineComponent（组件）](/wevu/component.md): defineComponent() 是对原生 Component() 的一层封装/增强：在组件 lifetimes.created 阶段初始化运行时并同步执行 setup()；setup() 返回对象会合并到组件实例，模板可直接使用。 - [Store（状态管理）](/wevu/store.md): Store（状态管理），聚焦 Wevu / store 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。 - [Wevu API 速查](/wevu/api.md): Wevu API 完整速查页，按 Vue 迁移兼容性、能力类型与运行作用域筛选公开能力。 ### Vue SFC 开发 - [Vue SFC 开发指南](/wevu/vue-sfc.md): Weapp-vite 内置了 Vue SFC 编译链路，配合 Wevu 运行时即可用 Vue 风格开发小程序页面/组件，同时保持小程序能力（页面特性、分享、性能优化）。 - [Vue SFC：基础与组成](/wevu/vue-sfc/basics.md): Vue SFC：基础与组成，聚焦 Wevu / vue-sfc 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。 - [Vue SFC：配置与宏](/wevu/vue-sfc/config.md): 小程序组件的注册是 **JSON 声明式** 的：只认 usingComponents。因此在 SFC 里推荐： - [Vue SFC：模板与指令](/wevu/vue-sfc/template.md): Vue SFC：模板与指令，聚焦 Wevu / vue-sfc 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。 - [Vue SFC：示例](/wevu/vue-sfc/examples.md): 这个示例展示一个自定义组件如何配合 v-model 工作。对于自定义组件，Weapp-vite 会把 v-model="x" 按默认策略编译为 value="{{x}}" + bind:input="x = $event.detail.v… - [Vue SFC：调试与排错](/wevu/vue-sfc/troubleshoot.md): Vue SFC：调试与排错，聚焦 Wevu / vue-sfc 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。 ### Namespace 导出 - [wevu/api](/wevu/api-package.md): 说明 wevu/api 的跨端 API 门面定位、与 uni/taro 风格对象的类比关系，以及在 Wevu 项目中的完整调用方式。 - [wevu/fetch](/wevu/fetch.md): 基于 @wevu/api 的 request 能力提供 Fetch 风格接口，说明 wevu/fetch 的定位、限制与推荐用法。 - [wevu/router](/wevu/router.md): wevu/router 子路径文档，介绍路径式导航、守卫、失败分类与小程序环境下的边界。 - [wevu/jsx-runtime](/wevu/jsx-runtime.md): 说明 wevu/jsx-runtime 的用途、适用范围与 TypeScript JSX 配置方式。 ### 进阶与迁移 - [兼容性与注意事项](/wevu/compatibility.md): 本页用于快速排雷：哪些能力能用、有哪些限制来自小程序环境，以及哪些点最容易踩坑。 - [Wevu 的 Vue 3 兼容性说明](/wevu/vue3-compat.md): Wevu 是一个面向小程序（以微信小程序为主）的 Vue 3 风格运行时：尽量提供熟悉的 Vue 3 API 形态，同时针对小程序运行环境进行适配与约束。 - [从原生小程序迁移到 Weapp-vite / Wevu](/wevu/migration/from-native-to-vue-sfc.md): 这是一份面向实际项目的迁移手册，不是概念介绍。目标是让你在不重写业务的前提下，按需迁移到 Weapp-vite + 原生，或继续升级到 Weapp-vite + Wevu + Vue SFC。 - [Wevu vs Vue 3：核心差异与小程序适配](/wevu/vue3-vs-wevu.md): Wevu vs Vue 3：核心差异与小程序适配，聚焦 Wevu / vue3-vs-wevu 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。 ### 扩展阅读 - [为什么没有使用 @vue/runtime-core 的 createRenderer 来实现](/wevu/why-not-runtime-core-create-renderer.md): 解释 Wevu 为什么没有采用 @vue/runtime-core 的 createRenderer 作为主实现路径，并给出当前架构下的可行替代方案与技术判断。 - [Wevu 中的 setData 什么时候触发？](/wevu/when-setdata-triggers.md): 从触发时机、调度批处理、差量下发与回退策略解释 Wevu 里的 setData 机制，理解它为何在小程序场景下更高效。 ### 开始上手 - [创建项目，跑起来](/handbook.md): 从零开始创建一个 Weapp-vite + Wevu 小程序项目，写出第一个页面，确认它能在开发者工具里正常运行。 - [目录结构怎么放最顺手](/handbook/project-structure.md): 从新用户和中小型业务项目的视角，解释 Weapp-vite 项目里的页面、组件、服务、状态和静态资源应该怎么落位。 - [环境变量与配置怎么分层](/handbook/env-and-config.md): 从新用户视角解释构建期变量、运行期配置和小程序 JSON 配置的边界，帮助你避免开发环境正常、线上环境出问题。 - [构建产物到底长什么样](/handbook/build-and-output.md): 帮你从源码、编译结果和开发者工具视角理解 Weapp-vite 的输出结构，以及为什么很多问题必须回到 dist 里看。 ### 写页面 - [.vue 怎么变成小程序](/handbook/sfc.md): 解释 .vue 文件在 weapp-vite 里是怎么被编译成小程序四件套的，以及写 Vue SFC 时哪些地方和 Web Vue 一样，哪些地方不一样。 - [模板和事件怎么写](/handbook/sfc/template.md): 小程序 SFC 模板的日常写法：条件渲染、列表、事件绑定、v-model，以及哪些 Web Vue 的习惯要收一收。 - [脚本逻辑怎么组织](/handbook/sfc/script-setup.md): 用 script setup 写页面和组件的推荐范式，包括代码组织顺序、生命周期用法、Options API 兼容写法。 - [样式和资源怎么处理](/handbook/sfc/style.md): SFC 里的样式怎么落到 WXSS、scoped 的真实行为、预处理器怎么选、图片和字体怎么引用。 - [组件怎么拆](/handbook/sfc/components.md): 什么时候该拆组件、怎么导入、什么时候还需要 usingComponents、原生组件怎么接类型。 - [常用写法速查](/handbook/sfc/cookbook.md): 小程序 SFC 项目里最常见的业务场景写法，可以直接照着改。 ### 理解运行时 - [Wevu 是什么，不是什么](/handbook/wevu.md): 搞清楚 wevu 在这套技术栈里的定位：它负责什么、不负责什么、和 Vue 是什么关系。 - [响应式和生命周期](/handbook/wevu/runtime.md): 理解 wevu 的 setup 上下文、响应式系统和页面更新机制。 - [组件通信](/handbook/wevu/component.md): 在 wevu 里怎么做 props、emit 和 slots，以及和 Web Vue 的区别。 - [状态管理](/handbook/wevu/store.md): 什么时候该上 store、什么时候页面本地状态就够了、store 怎么组织。 - [表单和双向绑定](/handbook/wevu/bind-model.md): v-model 的边界、什么时候该用显式写法、bindModel 解决什么问题。 ### 做业务 - [页面跳转与路由参数](/handbook/navigation.md): 用真实业务页面常见场景解释小程序导航 API、参数传递和页面栈管理，帮助新用户少走路由坑。 - [网络请求与数据层](/handbook/network.md): 从真实业务页面出发，解释请求封装、领域 service、store 和页面编排之间的边界，让新用户知道请求代码应该放在哪里。 - [原生能力调用与封装](/handbook/native-apis.md): 解释 wx.* 能力在真实项目里应该如何按模块封装、做能力探测、处理授权和失败降级，避免业务页面直接耦合平台细节。 - [分包与包体策略](/handbook/subpackages.md): 从真实业务模块拆分视角解释主包、分包、共享资源和加载体验，帮助新用户建立小程序包体优化的第一套规则。 ### 上线和维护 - [性能与体验优化](/handbook/performance.md): 按小程序项目的真实瓶颈来解释包体、渲染、setData、列表和资源优化，让新用户知道应该先优化什么、后优化什么。 - [调试与排错（按层定位）](/handbook/debugging.md): 用“先分层、再缩小、最后验证”的方式整理 Weapp-vite、SFC 编译链、Wevu 运行时和宿主侧常见问题的排查顺序。 - [构建、预览与上传](/handbook/publish.md): 把从本地构建到开发者工具预览、真机验证和上传发布的流程串成一条新用户可执行的上线前检查路线。 - [从旧项目迁移过来](/handbook/migration.md): 从原生小程序或旧工程结构迁移到 Weapp-vite + 原生，或继续迁移到 Weapp-vite + Wevu + Vue SFC 时，推荐采用分阶段、可回滚的迁移路线。 - [参考入口与速查索引](/handbook/reference.md): 帮你在遇到具体问题时，快速判断应该回到 guide、config、wevu 还是源码，避免在文档体系里来回迷路。 ### 迁移指南 - [迁移](/migration.md): 汇总从原生小程序迁移到 weapp-vite + 原生 / weapp-vite + wevu，以及历史大版本升级的迁移入口与阅读顺序。 - [从原生小程序迁移到 Weapp-vite / Wevu](/wevu/migration/from-native-to-vue-sfc.md): 这是一份面向实际项目的迁移手册，不是概念介绍。目标是让你在不重写业务的前提下，按需迁移到 Weapp-vite + 原生，或继续升级到 Weapp-vite + Wevu + Vue SFC。 - [从 v5 升级到 v6](/migration/v6.md): 从 v5 升级到 v6，聚焦 migration / v6 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。 - [从 v4 升级到 v5](/migration/v5.md): 从 v4 升级到 v5，聚焦 migration / v5 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。 - [从 v3 升级到 v4](/migration/v4.md): 由于 4 的更改，这导致我们项目中，假如需要引用外部的 cjs / umd 模块，比如: visactor index-wx-simple.min.js - [从 v2 升级到 v3](/migration/v3.md): 这可能会导致一些 vite 的配置项失效，请根据 v6 的文档进行配置。 ### Other - [AI 学习入口](/ai.md): 统一的 AI 学习入口，聚合 llms 语料、MCP 接入与 Weapp-vite / Wevu 技能安装方式。 - [API 参考（旧路径兼容）](/wevu/api-reference.md): /wevu/api-reference/ 为兼容旧链接保留；当前 Wevu API 的规范入口已经迁移到 /wevu/api/。 - [class/style 绑定能力](/wevu/vue-sfc/class-style.md): Weapp-vite + Wevu 在小程序侧对齐 Vue 3 的 :class / :style 绑定语法，支持字符串、数组、对象与嵌套组合，并会输出小程序可识别的字符串 class/style。 - [Core API（旧路径兼容）](/wevu/api-reference/core.md): 当前 Core API 的规范入口是 /wevu/api/core，本页仅用于兼容旧链接。 - [dashboard](/dashboard.md): const Dashboard = defineClientComponent(()=>{ return import('./.vitepress/components/Dashboard.vue') }) // import Dashb… - [Lifecycle API（旧路径兼容）](/wevu/api-reference/lifecycle.md): 当前 Lifecycle API 的规范入口是 /wevu/api/lifecycle，本页仅用于兼容旧链接。 - [Reactivity API（旧路径兼容）](/wevu/api-reference/reactivity.md): 当前 Reactivity API 的规范入口是 /wevu/api/reactivity，本页仅用于兼容旧链接。 - [Runtime Bridge API（旧路径兼容）](/wevu/api-reference/runtime-bridge.md): 当前 Runtime Bridge API 的规范入口是 /wevu/api/runtime-bridge，本页仅用于兼容旧链接。 - [SEO/GEO 质量门禁](/guide/seo-governance.md): 说明 Weapp-vite 文档站的 SEO/GEO 自动化治理流程，包括审计、质量检查、llms 索引生成与 CI 严格门禁。 - [Setup Context API（旧路径兼容）](/wevu/api-reference/setup-context.md): 当前 Setup Context API 的规范入口是 /wevu/api/setup-context，本页仅用于兼容旧链接。 - [Store API（旧路径兼容）](/wevu/api-reference/store.md): 当前 Store API 的规范入口是 /wevu/api/store，本页仅用于兼容旧链接。 - [Type Reference（旧路径兼容）](/wevu/api-reference/types.md): 当前 Type Reference 的规范入口是 /wevu/api/types，本页仅用于兼容旧链接。 - [Vue 3 SFC vs Weapp-vite SFC：写法对比](/wevu/vue-sfc/vue3-vs-weapp-sfc.md): 本文聚焦“写法层面”的相同与不同：当你用 Weapp-vite + Wevu 写 .vue 时，哪些与 Vue 3 SFC 一致，哪些会因为小程序编译/运行时而发生变化。 - [Vue SFC：基础与组成](/guide/vue-sfc/basics.md): Vue SFC：基础与组成，聚焦 guide / vue-sfc 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。 - [Vue SFC：模板与指令](/guide/vue-sfc/template.md): 本页已迁移至 /wevu/vue-sfc/template。 - [Vue SFC：示例](/guide/vue-sfc/examples.md): 本页已迁移至 /wevu/vue-sfc/examples。 - [Vue SFC：调试与排错](/guide/vue-sfc/troubleshoot.md): 本页已迁移至 /wevu/vue-sfc/troubleshoot。 - [Vue SFC：配置与宏](/guide/vue-sfc/config.md): Vue SFC：配置与宏，聚焦 guide / vue-sfc 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。 - [Weapp-vite 模板示例](/demos/my-app/README.md): Weapp-vite 模板项目的最小使用说明，覆盖开发、构建与打开微信开发者工具的基础命令。 - [Weapp-vite: 对小程序工程化的重新思考](/blog/drafts/weapp-vite-rethinking-slidev.md): 用于 20-30 分钟技术分享的 Slidev 稿件，聚焦 AI 协作、原子化样式、分包治理、HMR 与语法重写的工程化实践。 - [Weapp-vite: 对小程序工程化的重新思考（发布版）](/blog/drafts/weapp-vite-rethinking-release.md): 这不是功能清单，而是一篇面向真实项目的工程复盘：AI 协作、原子化样式、分包策略、热更新速度和语法重写，应该如何放进同一条链路。 - [Weapp-vite: 对小程序工程化的重新思考（技术深聊版）](/blog/drafts/weapp-vite-rethinking-deep-dive.md): 从源码与文档出发，拆解 Weapp-vite 在 AI 协作、原子化样式、分包策略、HMR 和 Vue SFC 语法重写上的工程取舍。 - [Weapp-vite: 对小程序工程化的重新思考（案例演示完整版）](/blog/drafts/weapp-vite-rethinking-slidev-detailed.md): 面向分享场景的 Slidev 完整案例稿，覆盖 AI 协作、原子化样式、分包策略、HMR 与语法重写的可执行演示流程。 - [Weapp-vite: 对小程序工程化的重新思考（草稿）](/blog/drafts/weapp-vite-rethinking.md): 这不是一篇功能罗列，而是从源码与文档出发，重新讨论小程序工程化里最关键的 5 件事：AI 协作、原子化样式、分包策略、热更新速度和语法改写。 - [website-weapp-vite](/CHANGELOG.md): Store API 统一从主入口导出，并补充 Wevu 使用文档与案例合集。 - [从原生小程序迁移到 Weapp-vite / Wevu](/wevu/vue-sfc/migrate-from-native.md): 本章节已迁移为独立迁移指南，不再归属到“Vue SFC 开发”子章节。 - [常见问题排查](/troubleshoot.md): 遇到构建或运行异常？先从以下问题入手自检，大多数情况都能在几分钟内定位原因。若仍未解决，可携带日志在 Issue 或社区群反馈。 - [模块化风格](/guide/module.md): Weapp-vite 基于 ESM（ECMAScript Modules）进行构建。建议在业务代码里尽量统一使用 import / export，这样类型推导、Tree Shaking、热更新都会更稳定。 - [让 AI 学习 Weapp-vite](/llms.md): 兼容入口（/llms），与 /ai 共享同一套 AI 学习页面（含 MCP 接入指引）。 - [调试与贡献](/guide/debug.md): 这份指南面向想要参与 Weapp-vite 开发或排查源码问题的伙伴。按照下面的步骤准备环境，就可以在本地命中断点、验证修改，并把贡献发送到社区。