微信小程序开发套件

三级层级调用规则：

1. 一级：需求分析 - 判断用户要做什么（新建/UI/云开发/性能/部署）
2. 二级：工具选择 - 根据需求选择最佳工具（见下方对比表）
3. 三级：执行指令 - 调用工具并返回结果

快速选择指南

一级：需求分析

二级 + 三级：工具选择与执行

每个场景的完整做法都在 references/ 下，按需读取 —— 本文件不重复细节。

三条最常用的起步路径

1. 纯小程序（最快） — 微信开发者工具 → 新建项目 → 填 AppID → 选目录。 细节见 项目结构
2. 带后端（推荐） — 用 @cloudbase/cli 创建项目（自动集成 CloudBase SDK）。 细节见 CloudBase 开发
3. 带 UI 组件库（推荐） — 新建项目后装 TDesign → 改 app.json → 改 project.config.json → 在开发者工具里「构建 npm」。 细节见 TDesign 组件

⚠️ 最高频的两个坑（都属 TDesign 接入）： ① 必须在 app.json 里删掉 "style": "v2"，否则组件样式冲突； ② project.config.json 需配好 packNpmManually / packNpmRelationList，否则「构建 npm」找不到包。

本文件从 655 行精简到约 160 行：原先内联的 530 行二级细节与 references/ 下的 8 篇文档重复， 已删除重复部分（原文备份在 D:\_trash_\2026-09-15\微信小程序开发套件\SKILL.md.bak）。 入口文件只保留「怎么选」，细节一律去 references。

通用规则

1. 项目结构规范

├── app.js                 # 小程序逻辑
├── app.json               # 小程序配置
├── app.wxss               # 全局样式
├── project.config.json     # 项目配置
├── sitemap.json           # 搜索引擎配置
├── pages/                 # 页面目录
│   └── index/
│       ├── index.js        # 页面逻辑
│       ├── index.json      # 页面配置
│       ├── index.wxml      # 页面模板
│       └── index.wxss     # 页面样式
├── components/           # 自定义组件目录
├── cloudfunctions/       # 云函数目录（如果使用云开发）
├── miniprogram_npm/      # npm 包构建目录
└── references/           # 参考文档目录（本 skill 使用）

2. 命名规范

• 文件/文件夹：小写字母 + 连字符（kebab-case），如 pages/user-profile/
• 组件：自定义组件使用 PascalCase，如 MyComponent
• 变量/函数：camelCase，如 getUserInfo
• 常量：UPPER_SNAKE_CASE，如 API_BASE_URL
• CSS 类：kebab-case，如 .user-profile-card

3. 性能优化建议

• 使用 Skyline 渲染引擎（高性能）
• 使用 scroll-view 替代页面滚动（避免卡顿）
• 使用 worklet 动画（在 UI 线程执行）
• 使用 虚拟列表（长列表优化）
• 使用 图片懒加载
• 使用 代码分包（减少首屏加载时间）

4. 调试技巧

// 1. 在微信开发者工具中调试
// 点击"调试" → 打开调试器 → 查看 Console/Network/Storage

// 2. 在真机上调试
// 点击"真机调试" → 扫描二维码 → 在手机上打开调试器

// 3. 查看云函数日志
// 登录 CloudBase 控制台 → 云函数 → 日志

References

故障排查