◀ 返回目录 05_开发 / 本地向导陪同服务小程序 05_开发/app/README.md

本地向导陪同服务小程序

原生小程序 + TypeScript + 微信云开发。

开发者工具已装：D:\微信小程序\开发者工具\微信web开发者工具 （记得打开 设置 → 安全设置 → 服务端口，否则命令行驱动不了它）

目录结构

图 1 目录结构 14 个节点 · 最深 3 层
根节点 一级 二级 更深 点节点可折叠／展开它的下级
  • D:\微信小程序_开发pp\
    • miniprogram\← 小程序代码（开发者工具的根）
      • app.ts云开发初始化在这里
      • app.json全局配置 / 页面路由
      • app.wxss全局样式
      • sitemap.json微信索引配置
      • pages\index\环境自检页（index.ts/wxml/wxss/json）
    • cloudfunctions\
      • quickstartFunctions\连通性自检云函数
    • typings\index.d.ts全局类型：IAppOption
    • project.config.jsonAppID：wxddf82681664ba8cb
    • project.private.config.json 个人设置（已 gitignore）
    • tsconfig.jsonstrict 模式 TS 配置
    • package.json仅 devDep：类型定义 + tsc

还差哪一步

环境与云函数都就绪。后端说明见 cloudfunctions/README.md。

装完工具后的操作顺序

  1. 打开开发者工具 → 扫码登录
  2. 选「导入项目」（不要选新建）→ 目录选 D:\微信小程序_开发pp
  3. AppID 会自动从 project.config.json 读出来，确认是 wxddf82681664ba8cb
  4. 工具顶部点「云开发」→ 开通 → 选基础版（免费额度够开发用）→ 复制「环境 ID」
  5. 把环境 ID 填进 miniprogram/app.ts 的 const CLOUD_ENV = '';
  6. 右键 cloudfunctions\quickstartFunctions → 「上传并部署：云端安装依赖」
  7. 编译 → 首页点「调用云函数 ping」→ 看到 云函数已连通 ✅ 就是全链路通了

已知坑