QQ小程序

QQ小程序#

平台概述#

QQ 小程序运行在手机 QQ 客户端内，面向 QQ 8 亿+ 活跃用户（偏年轻化）。最大特点是 与微信小程序 API 高度兼容（QML/QSS + qq.* 命名空间），迁移成本在所有平台中最低，且支持 PC 端 QQ 运行。

核心优势：

迁移成本极低：API/组件/语法与微信几乎一致，仅需替换命名空间
PC 端支持：可在 PC 版 QQ 中运行，覆盖桌面场景
QQ 系流量：QQ、QQ 空间、QQ 浏览器分发
年轻用户：适合校园社交、二次元、轻游戏等

典型场景：

社交互动：投票、匿名提问、星座运势
轻量工具：壁纸、头像、表情包
内容消费：轻小说、漫画、短视频聚合
校园场景：课表、查分、校园社区

设计规范#

尺寸单位#

支持 rpx：750rpx = 屏幕宽度（与微信通用）
也支持 px、vh/vw

组件规范#

组件体系与微信几乎完全一致：<view>, <text>, <image>, <scroll-view>, <swiper>
模板文件为 .qml（QML），样式为 .qss（QSS）
事件绑定用 bindtap（与微信一致）

导航模式#

与微信一致：qq.navigateTo / qq.redirectTo / qq.switchTab / qq.reLaunch / qq.navigateBack
页面栈最大深度：10 层

样式#

.qss 与 .wxss 高度兼容，rpx 通用

审核规范#

常见被拒原因#

类目不符：内容与所选服务类目不匹配
虚拟支付：iOS 上不得提供虚拟商品内购
诱导分享：禁止强制分享后才能使用
内容违规：涉政、涉黄、赌博等违禁内容
网页套壳：仅嵌入 H5 无原生体验

审核周期#

通常 1-3 个工作日
个人主体 vs 企业主体：企业主体审核更宽松、能力更多

企业 vs 个人#

支持个人开发者注册
支付、广告等能力多需企业主体

开发指南#

快速上手#

code

// app.js
App({
  onLaunch() {
    console.log('QQ 小程序启动')
  }
})

// pages/index/index.js
Page({
  data: { msg: 'Hello QQ' },
  onLoad() {
    console.log('页面加载')
  }
})

// pages/index/index.qml
<view class="container">
  <text>{{msg}}</text>
  <button bindtap="handleTap">点我</button>
</view>

常见陷阱#

PC 端适配：PC 版 QQ 屏幕尺寸/交互与移动端不同，需额外适配
命名空间：API 是 qq.* 而非 wx.*，直接复制微信代码需批量替换（跨端框架自动处理）
能力差异：部分微信新 API（如 onShareTimeline）在 QQ 不存在
支付限制：个人主体不支持 QQ 支付
域名白名单：request/uploadFile 必须先在后台配置合法域名

从微信迁移#

微信	QQ	说明
`wx.xxx`	`qq.xxx`	仅命名空间不同（批量替换即可）
`.wxml`	`.qml`	模板语法一致
`.wxss`	`.qss`	样式语法一致，rpx 通用
`wx.requestPayment`	`qq.requestPayment`	支付 API 基本一致
`bindtap`	`bindtap`	事件绑定一致

QQ 小程序是所有平台中从微信迁移成本最低的。

生态资源#

框架	支持度	说明
Taro	⭐⭐⭐	QQ 端支持完善
uni-app	⭐⭐⭐	内置 QQ 适配
原生开发	⭐⭐⭐	直接用 QML/QSS，类微信原生开发

库	说明
Vant	通过 Taro/uni-app 适配
TDesign	多端适配
WeUI	微信官方风格，QQ 端通用

社区资源#

官方文档：q.qq.com/wiki
QQ 开放平台：能力申请、数据查看
QQ 小程序社区：问答与反馈

版本更新#

近期重要变更#

PC 端运行：支持 PC 版 QQ 运行小程序
云开发：支持 Serverless 能力
广告变现：Banner、激励视频持续完善

特性

详细文档

QQ小程序#

平台概述#

设计规范#

尺寸单位#

组件规范#

导航模式#

样式#

审核规范#

常见被拒原因#

审核周期#

企业 vs 个人#

开发指南#

快速上手#

常见陷阱#

从微信迁移#

生态资源#

推荐框架#

推荐 UI 库#

社区资源#

版本更新#

近期重要变更#