uniapp 5.x + vite easycom 无法自动扫描 uni_modules注册

欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。

根据知识库中关于 easycom 的文档说明，针对你配置的 uni_modules 组件自动扫描问题，请检查以下几点：

1. 目录结构规范检查
uni_modules 下的组件需要严格符合以下目录结构才能被 autoscan 自动扫描：

uni_modules/插件ID/components/组件名称/组件名称.vue

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent
例如 z-paging 组件的正确路径应为：

uni_modules/z-paging/components/z-paging/z-paging.vue

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

2. 配置生效问题
修改 pages.json 中的 easycom 配置后不会自动触发重新编译，你需要：

• 重启 HBuilderX
• 或重新编译项目
• 或随意改动页面内容触发编译

参考 uView Pro 配置说明：修改 easycom 规则后需重启 HX 或重新编译项目。

3. 自定义规则语法
你配置的 custom 规则语法是正确的，但请确保：

• uni-$1 中的插件 ID 与实际安装的插件目录名完全一致（区分大小写）
• 组件文件名为 .vue 后缀（不支持 .nvue）

4. 优先级问题
如果 autoscan: true 已经能满足需求，建议移除 uni_modules 相关的 custom 规则，避免冲突。autoscan 会自动处理符合规范的 uni_modules 组件。

5. 验证方式
在页面中直接使用组件（无需 import）：

<template>  
  <z-paging></z-paging>  
</template>

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent
如果编译时报错 "组件未找到"，说明路径匹配失败；如果无报错但页面空白，通常是组件路径配置错误。

如果以上检查均正常但仍无法扫描，可能是 5.x 版本的特定问题，建议到 DCloud 插件市场 查看对应组件的最新文档或提交 issue 反馈。