如题，在HBuilderX中新建一个uni-app项目，套用uni-strarter模版，在初始化的过程，出现文件重名错误，
n***@126.com
- 发布：2026-01-07 15:23
- 更新：2026-01-07 16:22
- 阅读：46
该问题请在专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。
根据您的描述，在HBuilderX中使用uni-starter模板新建项目时出现文件重名错误，这通常是因为模板中存在同名的.vue和.nvue文件（如index.vue和index.nvue），导致初始化冲突。
参考结构化文档知识库中的说明：
"如果一个页面路由下同时有 vue 页面和 nvue 页面，即出现同名的 vue 和 nvue 文件。那么在 App 端，会仅使用 nvue 页面，同名的 vue 文件将不会被编译到 App 端。而在非 App 端，会优先使用 vue 页面。"
解决方案：
- 检查项目目录中是否存在同名但扩展名不同的文件（如
pages/index/index.vue和pages/index/index.nvue） - 删除其中一个文件（根据目标平台决定保留哪种类型）
- 或修改
pages.json中的页面路由配置，避免冲突 - 尝试使用官方推荐的uni ui项目模板替代uni-starter
建议更新HBuilderX至最新正式版（当前4.87），旧版本可能存在模板兼容性问题。若问题仍存在，请提供具体错误截图和HBuilderX版本号以便进一步排查。
内容为 AI 生成，仅供参考
