# Weapp-vite

> 把现代化的开发模式带入小程序!

## 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): 构建时原样复制到产物目录的静态资源目录。

#### 源码根目录

- [<srcRoot>](/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 配置一一对应。

#### 页面与组件

- [pages](/guide/directory-structure/pages.md): 主包页面目录，是自动路由的默认扫描入口之一。
- [components](/guide/directory-structure/components.md): 主包组件目录，默认参与自动导入组件扫描。

#### 分包与共享

- [<subPackageRoot>](/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): 自动路由和自动导入组件生成的类型声明文件，默认输出到 srcRoot 下。

### 指引

- [什么是 Weapp-vite ?](/guide/what-is-weapp-vite.md): Weapp-vite 是一个面向微信小程序的现代构建框架：尽量不改变你写原生小程序的方式（语法、目录结构都能沿用），但把 Vite 生态、TypeScript、CSS 预处理器和更顺滑的开发/构建流程带进来。你仍然写小程序，但开发体验会更…
- [快速开始](/guide.md): 执行以下命令，快速创建一个集成了 Weapp-vite 的原生微信小程序项目：
- [CLI 命令参考](/guide/cli.md): Weapp-vite CLI 命令参考，包含全局参数、原生命令、别名、常用示例，以及 weapp-ide-cli 透传规则。
- [AI 协作指南](/guide/ai.md): 面向 weapp-vite 团队的 AI 协作入口，聚焦 Skills、MCP 与 llms.txt 三大章节。
- [目录结构](/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 提供了一个可选的“自动路由”能力：扫描主包/分包的页面目录，自动生成路由清单，并通过虚拟模块 weapp-vite/auto-routes 导出。
- [WXML 增强](/guide/wxml.md): WXML 增强，聚焦 guide / wxml 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。
- [WXS 增强 experimental](/guide/wxs.md): WXS（WeiXin Script）是微信小程序提供的轻量脚本语言，常用于在模板里做一些同步的、简单的逻辑处理。它和 JavaScript 不完全一样，能力也更受限。
- [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 两种运行面。
- [Web 兼容矩阵 experimental](/guide/web-compat-matrix.md): 本文用于说明 Weapp-vite 在 Web 运行时（@weapp-vite/web）下的能力边界。 状态含义如下：

#### 自动导入组件

- [自动引入组件](/guide/auto-import.md): Weapp-vite 可以在构建阶段自动扫描并注册组件，让你在 WXML 里直接写组件标签，而不需要手动维护 usingComponents。
- [自定义 autoImportComponents Resolver](/guide/auto-import-resolver.md): weapp.autoImportComponents.resolvers 用来把 WXML 里的组件标签（例如 ）解析成小程序 usingComponents 需要的 from 路径（例如 @vant/weapp/button）。

### 深入 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 背后的执行流程。

### 指引

- [什么是 Weapp-vite ?](/guide/what-is-weapp-vite.md): Weapp-vite 是一个面向微信小程序的现代构建框架：尽量不改变你写原生小程序的方式（语法、目录结构都能沿用），但把 Vite 生态、TypeScript、CSS 预处理器和更顺滑的开发/构建流程带进来。你仍然写小程序，但开发体验会更…
- [快速开始](/guide.md): 执行以下命令，快速创建一个集成了 Weapp-vite 的原生微信小程序项目：
- [CLI 命令参考](/guide/cli.md): Weapp-vite CLI 命令参考，包含全局参数、原生命令、别名、常用示例，以及 weapp-ide-cli 透传规则。
- [AI 协作指南](/guide/ai.md): 面向 weapp-vite 团队的 AI 协作入口，聚焦 Skills、MCP 与 llms.txt 三大章节。
- [目录结构](/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 提供了一个可选的“自动路由”能力：扫描主包/分包的页面目录，自动生成路由清单，并通过虚拟模块 weapp-vite/auto-routes 导出。
- [WXML 增强](/guide/wxml.md): WXML 增强，聚焦 guide / wxml 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。
- [WXS 增强 experimental](/guide/wxs.md): WXS（WeiXin Script）是微信小程序提供的轻量脚本语言，常用于在模板里做一些同步的、简单的逻辑处理。它和 JavaScript 不完全一样，能力也更受限。
- [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 两种运行面。
- [Web 兼容矩阵 experimental](/guide/web-compat-matrix.md): 本文用于说明 Weapp-vite 在 Web 运行时（@weapp-vite/web）下的能力边界。 状态含义如下：

#### 自动导入组件

- [自动引入组件](/guide/auto-import.md): Weapp-vite 可以在构建阶段自动扫描并注册组件，让你在 WXML 里直接写组件标签，而不需要手动维护 usingComponents。
- [自定义 autoImportComponents Resolver](/guide/auto-import-resolver.md): weapp.autoImportComponents.resolvers 用来把 WXML 里的组件标签（例如 ）解析成小程序 usingComponents 需要的 from 路径（例如 @vant/weapp/button）。

### 深入 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 背后的执行流程。

### 指引

- [什么是 Weapp-vite ?](/guide/what-is-weapp-vite.md): Weapp-vite 是一个面向微信小程序的现代构建框架：尽量不改变你写原生小程序的方式（语法、目录结构都能沿用），但把 Vite 生态、TypeScript、CSS 预处理器和更顺滑的开发/构建流程带进来。你仍然写小程序，但开发体验会更…
- [快速开始](/guide.md): 执行以下命令，快速创建一个集成了 Weapp-vite 的原生微信小程序项目：
- [CLI 命令参考](/guide/cli.md): Weapp-vite CLI 命令参考，包含全局参数、原生命令、别名、常用示例，以及 weapp-ide-cli 透传规则。
- [AI 协作指南](/guide/ai.md): 面向 weapp-vite 团队的 AI 协作入口，聚焦 Skills、MCP 与 llms.txt 三大章节。
- [目录结构](/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 提供了一个可选的“自动路由”能力：扫描主包/分包的页面目录，自动生成路由清单，并通过虚拟模块 weapp-vite/auto-routes 导出。
- [WXML 增强](/guide/wxml.md): WXML 增强，聚焦 guide / wxml 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。
- [WXS 增强 experimental](/guide/wxs.md): WXS（WeiXin Script）是微信小程序提供的轻量脚本语言，常用于在模板里做一些同步的、简单的逻辑处理。它和 JavaScript 不完全一样，能力也更受限。
- [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 两种运行面。
- [Web 兼容矩阵 experimental](/guide/web-compat-matrix.md): 本文用于说明 Weapp-vite 在 Web 运行时（@weapp-vite/web）下的能力边界。 状态含义如下：

#### 自动导入组件

- [自动引入组件](/guide/auto-import.md): Weapp-vite 可以在构建阶段自动扫描并注册组件，让你在 WXML 里直接写组件标签，而不需要手动维护 usingComponents。
- [自定义 autoImportComponents Resolver](/guide/auto-import-resolver.md): weapp.autoImportComponents.resolvers 用来把 WXML 里的组件标签（例如 ）解析成小程序 usingComponents 需要的 from 路径（例如 @vant/weapp/button）。

### 深入 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 配置模型**：在 vite.config.ts 中增加一个 weapp 字段即可。你也可以把小程序专属配置拆到 weapp-vite.config.*，两者会合并。
- [基础目录与资源收集](/config/paths.md): 基础目录与资源收集 {#paths-config}，聚焦 config / paths 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。
- [构建输出与兼容](/config/build-and-output.md): 解释 Weapp-vite 的产物输出目录、JS 输出格式与兼容策略，以及这些配置对包体积和运行稳定性的影响。
- [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）编译链路。这里聚焦编译期可配置项。
- [分包配置](/config/subpackages.md): Weapp-vite 会读取 app.json.subPackages 来生成分包产物；weapp.subPackages 则用于 **构建期补充配置**（独立分包、依赖裁剪、共享样式等）。
- [Worker 配置](/config/worker.md): 当 app.json 配置了 workers 目录，Weapp-vite 可以帮助编译 Worker 入口脚本。
- [库模式配置](/config/lib.md): Weapp-vite 的 lib 模式用于构建小程序组件库或业务模块。本页聚焦 weapp.lib 的入口、输出路径、组件 JSON 和 DTS 选项。
- [生成脚手架配置](/config/generate.md): Weapp-vite generate 用于快速生成页面、组件和 App 基础文件。本页列出 weapp.generate 的字段，方便你把生成目录、文件名、后缀和模板内容对齐到团队习惯。**这些配置仅影响 CLI 生成器，不影响构建流程…
- [npm 配置](/config/npm.md): Weapp-vite 会自动把 **dependencies** 里的依赖构建成 miniprogram_npm/，而把 **devDependencies** 视为“仅构建期依赖”，直接内联进产物。
- [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/auto-import-components.md): Weapp-vite 会在构建阶段扫描 WXML 组件标签并自动补齐 usingComponents，免去手写 JSON 的负担。支持本地组件与第三方库 Resolver（如 Vant/TDesign）。
- [共享配置](/config/shared.md): 除了 WXML/WXS 这些“底层开关”，Weapp-vite 还有一些通用增强能力，比如自动路由、调试钩子等。本页主要讲：
- [Web 运行时配置 experimental](/config/web.md): Weapp-vite 可选集成浏览器端运行时（@weapp-vite/web），用于 Web 预览/调试。

### @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 全量清单 · 路由](/packages/weapi/wx-method-list/route.md): @wevu/api API 全量清单中的路由能力。
- [API 全量清单 · 跳转](/packages/weapi/wx-method-list/navigate.md): @wevu/api API 全量清单中的跳转能力。
- [API 全量清单 · 聊天工具](/packages/weapi/wx-method-list/chattool.md): @wevu/api API 全量清单中的聊天工具能力。
- [API 全量清单 · 转发](/packages/weapi/wx-method-list/share.md): @wevu/api API 全量清单中的转发能力。
- [API 全量清单 · 界面](/packages/weapi/wx-method-list/ui.md): @wevu/api API 全量清单中的界面能力。
- [API 全量清单 · 网络](/packages/weapi/wx-method-list/network.md): @wevu/api API 全量清单中的网络能力。
- [API 全量清单 · 支付](/packages/weapi/wx-method-list/payment.md): @wevu/api API 全量清单中的支付能力。
- [API 全量清单 · 数据缓存](/packages/weapi/wx-method-list/storage.md): @wevu/api API 全量清单中的数据缓存能力。
- [API 全量清单 · 数据分析](/packages/weapi/wx-method-list/data-analysis.md): @wevu/api API 全量清单中的数据分析能力。
- [API 全量清单 · 画布](/packages/weapi/wx-method-list/canvas.md): @wevu/api API 全量清单中的画布能力。
- [API 全量清单 · 媒体](/packages/weapi/wx-method-list/media.md): @wevu/api API 全量清单中的媒体能力。
- [API 全量清单 · 位置](/packages/weapi/wx-method-list/location.md): @wevu/api API 全量清单中的位置能力。
- [API 全量清单 · 文件](/packages/weapi/wx-method-list/file.md): @wevu/api API 全量清单中的文件能力。
- [API 全量清单 · 开放接口](/packages/weapi/wx-method-list/open-api.md): @wevu/api API 全量清单中的开放接口能力。
- [API 全量清单 · 设备](/packages/weapi/wx-method-list/device.md): @wevu/api API 全量清单中的设备能力。
- [API 全量清单 · AI](/packages/weapi/wx-method-list/ai.md): @wevu/api API 全量清单中的 AI 能力。
- [API 全量清单 · Worker](/packages/weapi/wx-method-list/worker.md): @wevu/api API 全量清单中的 Worker 能力。
- [API 全量清单 · WXML](/packages/weapi/wx-method-list/wxml.md): @wevu/api API 全量清单中的 WXML 能力。
- [API 全量清单 · 第三方平台](/packages/weapi/wx-method-list/ext.md): @wevu/api API 全量清单中的第三方平台能力。
- [API 全量清单 · 广告](/packages/weapi/wx-method-list/ad.md): @wevu/api API 全量清单中的广告能力。
- [API 全量清单 · XR-FRAME](/packages/weapi/wx-method-list/xr-frame.md): @wevu/api API 全量清单中的 XR-FRAME 能力。

#### 支付宝兼容矩阵

- [支付宝兼容矩阵 · 基础](/packages/weapi/alipay-compat-matrix/base.md): @wevu/api 支付宝兼容矩阵中的基础能力。
- [支付宝兼容矩阵 · 路由](/packages/weapi/alipay-compat-matrix/route.md): @wevu/api 支付宝兼容矩阵中的路由能力。
- [支付宝兼容矩阵 · 跳转](/packages/weapi/alipay-compat-matrix/navigate.md): @wevu/api 支付宝兼容矩阵中的跳转能力。
- [支付宝兼容矩阵 · 聊天工具](/packages/weapi/alipay-compat-matrix/chattool.md): @wevu/api 支付宝兼容矩阵中的聊天工具能力。
- [支付宝兼容矩阵 · 转发](/packages/weapi/alipay-compat-matrix/share.md): @wevu/api 支付宝兼容矩阵中的转发能力。
- [支付宝兼容矩阵 · 界面](/packages/weapi/alipay-compat-matrix/ui.md): @wevu/api 支付宝兼容矩阵中的界面能力。
- [支付宝兼容矩阵 · 网络](/packages/weapi/alipay-compat-matrix/network.md): @wevu/api 支付宝兼容矩阵中的网络能力。
- [支付宝兼容矩阵 · 支付](/packages/weapi/alipay-compat-matrix/payment.md): @wevu/api 支付宝兼容矩阵中的支付能力。
- [支付宝兼容矩阵 · 数据缓存](/packages/weapi/alipay-compat-matrix/storage.md): @wevu/api 支付宝兼容矩阵中的数据缓存能力。
- [支付宝兼容矩阵 · 数据分析](/packages/weapi/alipay-compat-matrix/data-analysis.md): @wevu/api 支付宝兼容矩阵中的数据分析能力。
- [支付宝兼容矩阵 · 画布](/packages/weapi/alipay-compat-matrix/canvas.md): @wevu/api 支付宝兼容矩阵中的画布能力。
- [支付宝兼容矩阵 · 媒体](/packages/weapi/alipay-compat-matrix/media.md): @wevu/api 支付宝兼容矩阵中的媒体能力。
- [支付宝兼容矩阵 · 位置](/packages/weapi/alipay-compat-matrix/location.md): @wevu/api 支付宝兼容矩阵中的位置能力。
- [支付宝兼容矩阵 · 文件](/packages/weapi/alipay-compat-matrix/file.md): @wevu/api 支付宝兼容矩阵中的文件能力。
- [支付宝兼容矩阵 · 开放接口](/packages/weapi/alipay-compat-matrix/open-api.md): @wevu/api 支付宝兼容矩阵中的开放接口能力。
- [支付宝兼容矩阵 · 设备](/packages/weapi/alipay-compat-matrix/device.md): @wevu/api 支付宝兼容矩阵中的设备能力。
- [支付宝兼容矩阵 · AI](/packages/weapi/alipay-compat-matrix/ai.md): @wevu/api 支付宝兼容矩阵中的 AI 能力。
- [支付宝兼容矩阵 · Worker](/packages/weapi/alipay-compat-matrix/worker.md): @wevu/api 支付宝兼容矩阵中的 Worker 能力。
- [支付宝兼容矩阵 · WXML](/packages/weapi/alipay-compat-matrix/wxml.md): @wevu/api 支付宝兼容矩阵中的 WXML 能力。
- [支付宝兼容矩阵 · 第三方平台](/packages/weapi/alipay-compat-matrix/ext.md): @wevu/api 支付宝兼容矩阵中的第三方平台能力。
- [支付宝兼容矩阵 · 广告](/packages/weapi/alipay-compat-matrix/ad.md): @wevu/api 支付宝兼容矩阵中的广告能力。
- [支付宝兼容矩阵 · XR-FRAME](/packages/weapi/alipay-compat-matrix/xr-frame.md): @wevu/api 支付宝兼容矩阵中的 XR-FRAME 能力。

#### 抖音兼容矩阵

- [抖音兼容矩阵 · 基础](/packages/weapi/douyin-compat-matrix/base.md): @wevu/api 抖音兼容矩阵中的基础能力。
- [抖音兼容矩阵 · 路由](/packages/weapi/douyin-compat-matrix/route.md): @wevu/api 抖音兼容矩阵中的路由能力。
- [抖音兼容矩阵 · 跳转](/packages/weapi/douyin-compat-matrix/navigate.md): @wevu/api 抖音兼容矩阵中的跳转能力。
- [抖音兼容矩阵 · 聊天工具](/packages/weapi/douyin-compat-matrix/chattool.md): @wevu/api 抖音兼容矩阵中的聊天工具能力。
- [抖音兼容矩阵 · 转发](/packages/weapi/douyin-compat-matrix/share.md): @wevu/api 抖音兼容矩阵中的转发能力。
- [抖音兼容矩阵 · 界面](/packages/weapi/douyin-compat-matrix/ui.md): @wevu/api 抖音兼容矩阵中的界面能力。
- [抖音兼容矩阵 · 网络](/packages/weapi/douyin-compat-matrix/network.md): @wevu/api 抖音兼容矩阵中的网络能力。
- [抖音兼容矩阵 · 支付](/packages/weapi/douyin-compat-matrix/payment.md): @wevu/api 抖音兼容矩阵中的支付能力。
- [抖音兼容矩阵 · 数据缓存](/packages/weapi/douyin-compat-matrix/storage.md): @wevu/api 抖音兼容矩阵中的数据缓存能力。
- [抖音兼容矩阵 · 数据分析](/packages/weapi/douyin-compat-matrix/data-analysis.md): @wevu/api 抖音兼容矩阵中的数据分析能力。
- [抖音兼容矩阵 · 画布](/packages/weapi/douyin-compat-matrix/canvas.md): @wevu/api 抖音兼容矩阵中的画布能力。
- [抖音兼容矩阵 · 媒体](/packages/weapi/douyin-compat-matrix/media.md): @wevu/api 抖音兼容矩阵中的媒体能力。
- [抖音兼容矩阵 · 位置](/packages/weapi/douyin-compat-matrix/location.md): @wevu/api 抖音兼容矩阵中的位置能力。
- [抖音兼容矩阵 · 文件](/packages/weapi/douyin-compat-matrix/file.md): @wevu/api 抖音兼容矩阵中的文件能力。
- [抖音兼容矩阵 · 开放接口](/packages/weapi/douyin-compat-matrix/open-api.md): @wevu/api 抖音兼容矩阵中的开放接口能力。
- [抖音兼容矩阵 · 设备](/packages/weapi/douyin-compat-matrix/device.md): @wevu/api 抖音兼容矩阵中的设备能力。
- [抖音兼容矩阵 · AI](/packages/weapi/douyin-compat-matrix/ai.md): @wevu/api 抖音兼容矩阵中的 AI 能力。
- [抖音兼容矩阵 · Worker](/packages/weapi/douyin-compat-matrix/worker.md): @wevu/api 抖音兼容矩阵中的 Worker 能力。
- [抖音兼容矩阵 · WXML](/packages/weapi/douyin-compat-matrix/wxml.md): @wevu/api 抖音兼容矩阵中的 WXML 能力。
- [抖音兼容矩阵 · 第三方平台](/packages/weapi/douyin-compat-matrix/ext.md): @wevu/api 抖音兼容矩阵中的第三方平台能力。
- [抖音兼容矩阵 · 广告](/packages/weapi/douyin-compat-matrix/ad.md): @wevu/api 抖音兼容矩阵中的广告能力。
- [抖音兼容矩阵 · XR-FRAME](/packages/weapi/douyin-compat-matrix/xr-frame.md): @wevu/api 抖音兼容矩阵中的 XR-FRAME 能力。

### 总览

- [周边包总览](/packages.md): Weapp-vite 不只是一个构建器，packages/* 里还提供了脚手架、CLI、编译器、跨端 API、实验运行时和性能分析工具。

### 工程工具

- [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 清单。

### 示例与实验

- [@weapp-vite/mcp](/packages/mcp.md): @weapp-vite/mcp 是 weapp-vite 与 wevu 的 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 文档入口页，按主题聚合 API 参考与使用说明，便于快速定位能力域。

### Global API

- [Core API](/wevu/api/core.md): 本页聚焦 Wevu 的入口能力、组件定义、script setup 宏与模板工具，采用逐 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 的公开导出，包含 defineStore、createStore、storeToRefs 及相关类型。
- [Runtime Bridge API](/wevu/api/runtime-bridge.md): 本页仅展示面向业务与配置层的 Wevu 运行时 API。框架内部桥接函数不会在文档中展开。

### Type API

- [Type Reference](/wevu/api/types.md): 本页仅保留业务开发最常用的公开类型。内部运行时类型不会在文档中展开。

### API 首页

- [Wevu API](/wevu/api.md): Wevu API 文档入口页，按主题聚合 API 参考与使用说明，便于快速定位能力域。

### Global API

- [Core API](/wevu/api/core.md): 本页聚焦 Wevu 的入口能力、组件定义、script setup 宏与模板工具，采用逐 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 的公开导出，包含 defineStore、createStore、storeToRefs 及相关类型。
- [Runtime Bridge API](/wevu/api/runtime-bridge.md): 本页仅展示面向业务与配置层的 Wevu 运行时 API。框架内部桥接函数不会在文档中展开。

### Type API

- [Type Reference](/wevu/api/types.md): 本页仅保留业务开发最常用的公开类型。内部运行时类型不会在文档中展开。

### Wevu

- [Wevu 概览](/wevu.md): Wevu 是一个面向小程序（以微信小程序为主）的轻量运行时。可以把它看作“把 Vue 3 的响应式心智模型带到小程序里”，但不引入 Virtual DOM，而是用快照 diff 来尽量减少 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 文档入口页，按主题聚合 API 参考与使用说明，便于快速定位能力域。

### 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 形态，同时针对小程序运行环境进行适配与约束。
- [从原生小程序迁移到 Vue SFC](/wevu/migration/from-native-to-vue-sfc.md): 这是一份面向实际项目的迁移手册，不是概念介绍。目标是让你在**不重写业务**的前提下，把原生小程序稳定迁移到 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 机制，理解它为何在小程序场景下更高效。

### 迁移指南

- [迁移](/migration.md): 迁移，聚焦 migration / index 相关场景，覆盖 Weapp-vite 与 Wevu 的能力、配置和实践要点。
- [从原生小程序迁移到 Vue SFC](/wevu/migration/from-native-to-vue-sfc.md): 这是一份面向实际项目的迁移手册，不是概念介绍。目标是让你在**不重写业务**的前提下，把原生小程序稳定迁移到 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 参考首页。按 Vue API 风格提供分组导航，先定位能力域，再跳转到对应 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): 本页聚焦 Wevu 的“最先接触”能力：应用入口、组件定义、宏，以及模板辅助函数。
- [dashboard](/dashboard.md): const Dashboard = defineClientComponent(()=>{ return import('./.vitepress/components/Dashboard.vue') }) // import Dashb…
- [Lifecycle API](/wevu/api-reference/lifecycle.md): Wevu 生命周期 API 都需要在 setup() 的同步阶段调用。
- [Reactivity API](/wevu/api-reference/reactivity.md): 本页覆盖 Wevu 响应式层的公共 API，聚焦业务可直接使用的能力。
- [Runtime Bridge API](/wevu/api-reference/runtime-bridge.md): 本页覆盖 Wevu 与小程序原生运行时之间的桥接能力，以及用于排错/调优的公共 API。
- [SEO/GEO 质量门禁](/guide/seo-governance.md): 说明 Weapp-vite 文档站的 SEO/GEO 自动化治理流程，包括审计、质量检查、llms 索引生成与 CI 严格门禁。
- [Setup Context API](/wevu/api-reference/setup-context.md): Wevu 的 setup(props, ctx) 除了 Vue 语义，还补齐了小程序运行时场景，特别是 ctx.instance（原生实例）和 ctx.emit（事件派发）。
- [Store API](/wevu/api-reference/store.md): Wevu 的 store 设计接近 Pinia：defineStore 定义，createStore 创建管理器，storeToRefs 安全解构。
- [Type Reference](/wevu/api-reference/types.md): 本页先给出“高频类型速查”，然后提供 Wevu 当前导出的接口/类型别名全量索引。
- [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: 对小程序工程化的重新思考](/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 使用文档与案例合集。
- [从原生小程序迁移到 Vue SFC](/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 开发或排查源码问题的伙伴。按照下面的步骤准备环境，就可以在本地命中断点、验证修改，并把贡献发送到社区。
- [面向多平台构建](/guide/multi-platform.md): Weapp-vite 内置了多端适配能力：在开发/构建命令后追加 --platform （或短写 -p ），即可输出目标平台所需的文件后缀与目录结构。