文件路由

uniAutoPages 会把页面文件结构转换成 src/pages.json 中的页面配置，让页面新增、删除和迁移都能通过文件系统同步。

使用示例

假设项目结构如下：

src/
├─ pages/
│  ├─ index/index.vue
│  └─ more/test.vue
└─ subPackages/
   └─ tutorial/
      └─ pages/index/index.vue

配置 mainPackage 与 subPackages：

import { uniAutoPages } from "vite-plugin-uni-inject";

export default defineConfig({
  plugins: [
    uniAutoPages({
      mainPackage: "pages",
      subPackages: ["subPackages/tutorial"],
      dts: "./types/uni-pages.d.ts",
    }),
  ],
});

插件会生成类似的 pages.json：

{
  "pages": [
    {
      "path": "pages/index/index"
    },
    {
      "path": "pages/more/test"
    }
  ],
  "subPackages": [
    {
      "root": "subPackages/tutorial",
      "pages": [
        {
          "path": "pages/index/index"
        }
      ]
    }
  ]
}

pages.json 中已有的其他顶层配置会被保留，例如 globalStyle、easycom 等。

生成时机

默认情况下，只要页面文件结构发生变化，正常跑一次项目就会自动生成。

缓存机制

插件会通过独立的缓存文件记录上次生成的内容，避免重复写入导致文件变更。

强制重新生成

如果发现由于缓存导致页面配置未按预期更新，可以通过以下两种方式清除缓存：

• 移除插件生成的 .d.ts 文件（推荐）
• 移除 node_modules/.vite/vite-plugin-uni-inject 的缓存目录