hbuilderx新建uni-app项目需四步：启动后等待菜单完整显示，再通过“文件→新建→项目”打开向导；必须选“uni-app项目”模板，项目名用英文小写加短横线，路径不含中文和空格；推荐选“uni-ui项目模板”；点击创建后静待右下角提示消失，确认项目树含pages.json等文件即成功。
刚装完HBuilderX，想立刻跑通第一个uni-app项目，但卡在新建项目这一步——菜单找不到、模板不会选、项目名填中文后编译报错、点“创建”后右下角一直显示“正在初始化项目”却没反应，这些都不是配置问题，而是创建流程中几个关键动作没踩准。
启动HBuilderX并进入新建项目向导
双击桌面图标或从开始菜单启动HBuilderX，等待界面完全加载（状态栏不显示“未就绪”字样）；不要急着写代码，先确认左上角菜单栏完整显示“文件→编辑→视图→项目→工具→运行→调试→窗口→帮助”。
点击【文件】→【新建】→【项目】，弹出“新建项目”对话框；如果此处菜单灰掉，说明HBuilderX尚未完成首次初始化，需等待10–20秒再试。
选择uni-app模板并填写基础信息
在“新建项目”窗口左侧列表中，【必须选中“uni-app项目”】，不是“普通项目”或“微信小程序项目”；右侧配置区会自动切换为uni-app专属选项。
项目名称：输入英文小写字母+短横线组合，例如my-news-app；【严禁使用中文、空格、大写字母或特殊符号】，否则后续在微信开发者工具中会触发路径解析失败，且无法通过编译校验。
项目路径：点击右侧“浏览”按钮，选择一个**不含中文、不含空格、盘符非C盘根目录**的文件夹，例如D:\uni-projects\；若路径含中文，HBuilderX可能静默跳过依赖安装步骤，导致项目结构残缺。
模板选择：新手直接选【uni-ui项目模板】；它已预置TabBar、页面路由、状态管理骨架和常用UI组件，比“Hello uni-app”精简，“空白模板”则需手动补全pages.json等核心配置。
完成创建并验证项目结构
点击“创建”按钮后，HBuilderX右下角出现“正在初始化项目”提示；此时不要关闭窗口、不要重复点击、不要切换标签页——这是npm install在后台执行，普通电脑需15–40秒，期间资源管理器可观察node_modules文件夹大小持续增长。
提示消失后，左侧项目树应完整展开，包含App.vue、main.js、pages、static、manifest.json、pages.json等关键文件；若缺失pages.json或node_modules为空，说明初始化失败，需删除项目文件夹后重试。
双击打开pages/index/index.vue，能看到默认的欢迎文案；此时项目创建已完成，可直接进入开发阶段。
