生成脚手架配置
weapp-vite generate 命令可以快速创建页面、组件或应用入口。本节整理 weapp.generate 的所有字段，帮助你自定义目录、文件名、后缀与内置模板。
weapp.generate
- 类型：ts
{ extensions?: Partial<{ js: string; json: string; wxml: string; wxss: string }> dirs?: Partial<{ app: string; page: string; component: string }> filenames?: Partial<{ app: string; page: string; component: string }> templates?: TemplatesConfig } type TemplatesConfig = Partial<Record<'shared' | 'component' | 'page' | 'app', GenerateTemplateEntry>> type GenerateTemplateEntry = Partial<Record<'js' | 'json' | 'wxml' | 'wxss', TemplateSource>> type TemplateSource = | string | { path: string } | { content: string } | ((ctx: TemplateContext) => string | undefined | Promise<string | undefined>) interface TemplateContext { type: 'component' | 'page' | 'app' fileType: 'js' | 'json' | 'wxml' | 'wxss' fileName: string outDir: string extension: string cwd: string defaultCode?: string } - 默认值：
undefined - 适用场景：
- 通过命令行创建页面/组件时统一使用团队习惯的目录与文件结构。
- 动态生成自定义模板内容，例如为每个页面附带国际化占位、预置样式等。
配置示例
ts
export default defineConfig({
weapp: {
generate: {
extensions: {
js: 'ts',
json: 'jsonc',
wxss: 'scss',
},
dirs: {
page: 'src/pages',
component: 'src/components',
},
filenames: {
app: 'app',
page: 'index',
},
templates: {
shared: {
wxss: () => '.root { color: red; }',
},
component: {
js: { content: 'Component({ custom: true })' },
},
},
},
},
})字段说明
extensions: 覆写生成文件的默认后缀，例如将 JS 切换为 TS、将 WXSS 改为 SCSS。dirs: 定义生成文件的默认目录。支持分别指定app、page、component的输出路径。filenames: 定制生成文件的默认文件名，如页面默认生成index.ts、组件默认生成main.json等。templates: 为不同类型生成自定义文件内容。支持字符串、文件路径或工厂函数：string: 直接写入内容。{ path: './template.wxml' }: 从指定文件读取。{ content: '...' }: 直接提供内容对象。- 函数：根据
TemplateContext运行时返回字符串或undefined，可结合条件逻辑灵活生成。
常见问题
- CLI 会覆盖已有文件吗？ 不会，生成命令只对全新文件生效，若目标文件已存在会提示冲突。
- 如何生成多语言模板？ 可将
extensions.json设置为jsonc，编写带注释的默认内容或国际化占位。 - 模板如何复用？ 利用
templates.shared为所有类型提供统一的基础内容，再在component、page、app中覆写特定文件。