uniapp / uniappx 调试助手

在 VS Code 中一站式驱动 HBuilderX CLI 的 App 调试 与 npm 方式的 Web / 小程序 / 编译，并管理 pages.json 页面注册。专为「项目已在编辑器中打开」的工作流设计——不需要再去磁盘里翻目录。

三个独立视图

活动栏中会出现「tmui UniApp」图标，内含三个并列面板：

1. App 运行调试（依赖 HBuilderX CLI）

• 选择 HBuilderX 根目录：定位 cli.exe / cli。
• 启动 HBuilderX：手动拉起 HBuilderX；扫描设备与运行调试都不会自动启动它，由你先启动。
• 切换项目：只从「当前已打开」的工作区文件夹中，自动识别 uniapp 项目并列表选择：
  • HBX 项目 → 根目录存在 manifest.json
  • CLI 项目 → 存在 src/manifest.json
  • 有调试任务正在运行时禁止切换，必须先停止全部。
• 平台 / 设备：Android、iOS 真机、iOS 模拟器、鸿蒙；设备列表来自 cli devices list。
• 运行方式：使用缓存 / 清缓存运行。
• 页面调试：
  • 锁定当前页面：以当前文件对应的 pagePath 启动。
  • 自动调试页面：切换页面文件时自动重启到对应页面。
  • 选择项持久化，重载编辑器后保持不变。
• 生成打包资源：cli publish ... --type appResource。

2. Web / 小程序·编译（依赖 npm，不依赖 HBuilderX）

自动读取项目 package.json 中的脚本并分组呈现：

• 调试：dev:*（H5、各家小程序、快应用…）。运行 dev:h5 时自动侦测本地地址并在侧边打开 414 宽度的预览面板；切换页面文件时同步导航。
• 编译：build:*。

检测不到脚本（例如纯 HBX 项目）时静默提示，不弹错。

3. 页面管理

按「主包 / 分包」分组列出 pages.json 中的页面，标题取 navigationBarTitleText：

• 打开页面：点击定位并打开页面文件（兼容 .vue / .uvue / .nvue）。
• 复制页面路径（行内）：复制形如 /pages/x/x 的访问路径。
• 移除页面注册（行内减号）：仅从 pages.json 移除该页登记，不会删除页面文件。
• 新增页面：交互式创建页面文件并写入 pages.json。

运行方式的关键区别

两者互不依赖，因此在界面上被拆成两个视图。

微信小程序自动化调试

点击「Web/小程序·编译」视图中的 微信小程序 时，扩展会：

1. 运行 npm run dev:mp-weixin 编译项目
2. 编译成功后，自动启动微信开发者工具并导入编译输出
3. 在工具中可直接预览、调试小程序

前置配置：

1. 在微信开发者工具中开启：设置 → 安全设置 → 勾选「CLI / HTTP 调用」
2. 在 VS Code 设置中配置 tmui.mpWeixin.cliPath（可选，有默认路径）
3. 确保微信开发者工具版本 ≥ 1.02.1907232

miniprogram-automator 已内置在插件中，用户无需手动安装。切换页面文件时，扩展会自动通知已连接的开发者工具跳转到对应页面。

配置项

提示：若 VS Code 弹出内置的「npm 任务检测: 无法分析文件」，那是编辑器自带的 npm 任务自动探测所致，与本插件无关；可在设置中将 npm.autoDetect 设为 off 关闭。

版权归属

本插件由 tmui 开发维护，版权归 tmui 所有。