本文为通用小程序开发技术规范大全，适配微信、支付宝、抖音主流小程序平台，覆盖零基础入门、标准化开发、进阶架构搭建、高级性能优化、安全合规、项目落地全流程，是一套可直接落地、统一团队开发标准、适配中小型项目及大型商业项目的完整技术手册。规范兼顾新手入门学习与资深开发优化进阶需求，明确代码、架构、性能、安全、工程化等核心标准，解决小程序开发混乱、兼容性差、性能卡顿、迭代困难等常见问题。
第一章 小程序开发入门基础规范（零基础必备）
1.1 开发环境与工具规范
1.1.1 官方工具统一配置
所有小程序项目必须使用对应平台官方开发者工具开发，禁止使用第三方篡改工具，保障编译、预览、上传、审核流程合规稳定：微信小程序使用微信开发者工具、支付宝小程序使用支付宝开发者工具、抖音小程序使用抖音开发者工具。工具统一开启ES6转ES5、代码压缩、样式自动补全、错误实时校验基础配置，关闭冗余调试插件，避免编译异常。
版本规范：团队项目统一锁定工具版本，禁止个人随意升级，防止新旧版本编译规则差异导致项目报错；新项目优先使用最新稳定版工具，适配平台最新API与语法规范。
1.1.2 基础运行原理认知
主流小程序均采用双线程隔离+四层分层架构，分为视图线程与逻辑线程，视图线程负责WXML渲染、WXSS样式展示，逻辑线程负责JS业务处理、API调用、数据交互，双线程隔离可避免逻辑代码阻塞页面渲染，保障页面流畅度，这是小程序性能优化的核心底层原理。小程序属于轻量级混合应用，介于H5与原生APP之间，依托宿主APP原生能力运行，无需安装，具备轻量化、低门槛、高适配的特点。
1.2 项目目录结构规范（统一通用）
所有项目强制遵循标准化目录分层，区分静态资源、业务页面、公共组件、工具方法、配置文件，杜绝文件杂乱堆放，方便多人协作与后期迭代维护，通用标准目录结构如下：
project
├── components       // 全局公共自定义组件（复用性强的弹窗、导航、卡片等）
├── pages            // 业务页面目录（所有业务页面统一收纳）
│   ├── index        // 首页模块
│   │   ├── index.js
│   │   ├── index.json
│   │   ├── index.wxml
│   │   └── index.wxss
│   └── ...          // 其他业务页面
├── static           // 静态资源目录（图片、图标、字体文件，禁止存放业务代码）
│   ├── images
│   └── fonts
├── utils            // 公共工具方法（请求封装、时间处理、正则、防抖节流等）
├── store            // 全局状态管理文件（进阶项目使用）
├── config           // 全局配置（环境变量、接口地址、常量配置）
├── app.js           // 小程序全局逻辑
├── app.json         // 全局配置（页面路由、导航栏、权限、全局组件）
└── app.wxss         // 全局样式
补充规范：单页面文件夹仅存放当前页面的4类基础文件，禁止跨页面混用文件；自定义组件统一归类，页面私有组件可存放至对应页面文件夹的components子目录，区分全局复用与页面私有组件。
1.3 基础文件语法规范（WXML/WXSS/JS/JSON）
1.3.1 WXML 结构规范
WXML为小程序专属标记语言，遵循类HTML语法，禁止直接使用HTML标签，严格使用小程序内置基础组件。核心规范：标签语义化、层级简洁、避免冗余嵌套，单页面标签嵌套层级不超过10层；数据绑定统一使用双大括号 {{}}，事件绑定统一使用bind/catch，catch用于阻止事件冒泡，bind为正常事件绑定，禁止混用；列表渲染必须设置唯一key，优先使用业务唯一id，禁止使用index索引，避免列表渲染错乱。
1.3.2 WXSS 样式规范
兼容大部分CSS3特性，新增小程序专属适配规则，核心强制规范：统一使用rpx响应式单位（1rpx=0.5px），适配所有手机屏幕，禁止固定px硬编码；支持@import样式导入，全局公共样式统一在app.wxss引入，页面私有样式独立编写；区分全局样式与局部样式，页面样式优先局部覆盖全局，避免样式污染。
样式编码规范：采用类名命名法（小写+下划线），禁止使用拼音、无意义字符；样式模块化，公共样式抽