# 小程序开发

## 规则（Rules）

# 小程序开发规范

## 适用对象和范围

本规范适用于所有使用微信小程序框架进行小程序应用开发的场景。

---

## 1. 文件结构规范

**规则**：每个页面必须包含WXML、WXSS、JS、JSON四个文件。

- ✅ 正确：`index.wxml` + `index.wxss` + `index.js` + `index.json`
- ❌ 错误：缺少WXSS或JSON文件

**违反后果**：缺少文件导致页面渲染异常或配置缺失。

---

## 2. API兼容性规范

**规则**：禁止使用不兼容的API（小程序API与浏览器API不同）。

- ✅ 正确：使用 `wx.request()`、`wx.setStorageSync()`
- ❌ 错误：使用 `fetch()`、`localStorage`

**违反后果**：使用浏览器API导致小程序运行时报错。

## 方法（Methods）

# 小程序开发方法

## 前置条件

- [ ] 已获取需求文档
- [ ] 已了解小程序平台规范

## 流程概览

分析需求 → 开发页面 → 实现功能 → 测试交付

## 详细步骤

### 步骤1：分析需求
分析需求文档，确定小程序功能和页面结构。

### 步骤2：开发页面
对每个页面创建WXML/WXSS/JS/JSON四个文件。

### 步骤3：实现功能
编写全局逻辑和配置文件。

## 技巧（Tips）

# 小程序开发技巧

## 1. 使用setData更新数据

**适用场景**：需要更新页面数据时。

**具体做法**：使用 `this.setData()` 更新数据，触发页面重新渲染。

**注意事项**：`setData` 传输数据量有限制（单次不超过1MB），大数据量需分批处理。

## 2. 常见问题速查

| 问题 | 原因 | 解决方案 |
|------|------|---------|
| 页面渲染异常 | WXML结构错误 | 检查标签闭合 |
| 接口调用失败 | 域名未配置 | 在小程序后台配置request合法域名 |
| 样式不生效 | WXSS选择器错误 | 使用小程序支持的CSS选择器 |