Skip to content

shingle666/miniprogram-academy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

小程序研究院 (mp.ac.cn)

专业的小程序开发研究与资源平台

VitePress License Node.js Build Status Multi-Language

📋 目录导航

📖 项目简介

小程序研究院是一个专注于小程序开发的综合性平台,致力于为开发者提供全方位的小程序开发支持和资源。平台采用现代化的技术栈,提供中英双语支持,涵盖从入门到精通的完整学习路径。

🌟 支持的小程序平台

我们覆盖主流小程序平台的开发指南和最佳实践:

🛠️ 主流开发框架

深入解析各种小程序开发框架,帮助开发者选择最适合的技术栈:

跨平台开发框架

  • 🚀 Taro - 京东开源,React语法,一套代码多端运行
  • uni-app - DCloud开发,Vue语法,覆盖H5/App/小程序
  • 🔥 Remax - 阿里开源,使用React开发小程序
  • 💫 Chameleon - 滴滴开源,一套代码运行多端

原生开发框架

  • 微信原生框架 - 官方WXML/WXSS/JS开发方式
  • 支付宝原生框架 - AXML/ACSS/JS开发模式
  • 百度原生框架 - Swan框架,AI能力集成

🎯 平台核心功能

小程序研究院为开发者提供:

  • 📚 完整的开发文档 - 涵盖所有主流平台和框架的详细指南
  • 🎯 丰富的案例展示 - 精选优质小程序案例,涵盖电商、工具、教育、游戏、生活服务等多个行业
  • 🛠️ 专业的开发工具 - 整合各平台开发工具、UI组件库和辅助工具
  • 👥 活跃的开发社区 - 多平台开发者交流学习的互动平台
  • 🔄 跨平台解决方案 - 一套代码适配多个小程序平台的最佳实践
  • 📊 性能优化指南 - 各平台性能优化技巧和监控方案
  • 🔒 安全最佳实践 - 数据安全、权限管理、合规指南
  • 🚀 部署与运维 - CI/CD、监控、维护的完整解决方案

🚀 快速开始

环境要求

  • Node.js 18.0 或更高版本
  • npm 或 yarn 包管理器
  • Git 版本控制工具

克隆项目

git clone https://github.com/shingle666/miniprogram-academy.git
cd miniprogram-academy

安装依赖

npm install

启动开发服务器

npm run dev

访问 http://localhost:5173 查看网站

构建生产版本

npm run build

预览生产版本

npm run serve

📁 项目结构

mp.ac.cn/
├── docs/                          # 文档源文件
│   ├── .vitepress/                # VitePress 配置
│   │   ├── config.ts              # 站点配置文件(多语言支持)
│   │   ├── cache/                 # 构建缓存
│   │   └── theme/                 # 自定义主题
│   ├── public/                    # 静态资源
│   │   ├── logo.svg               # 网站Logo
│   │   ├── favicon.svg            # 网站图标
│   │   ├── hero-image.svg         # 首页英雄图片
│   │   ├── case-*.svg             # 案例展示图片
│   │   └── images/                # 图片资源目录
│   ├── index.md                   # 网站首页(中文版内容)
│   ├── zh/                        # 中文文档
│   │   ├── index.md               # 中文首页
│   │   ├── guide/                 # 开发指南
│   │   │   ├── getting-started.md # 快速开始
│   │   │   ├── basic-concepts.md  # 基础概念
│   │   │   ├── development-environment.md # 开发环境
│   │   │   ├── performance-optimization.md # 性能优化
│   │   │   ├── security.md        # 安全指南
│   │   │   ├── monitoring.md      # 监控指南
│   │   │   ├── maintenance.md     # 维护指南
│   │   │   ├── testing.md         # 测试指南
│   │   │   └── device-capabilities.md # 设备能力
│   │   ├── platforms/             # 平台对比
│   │   │   ├── wechat.md          # 微信小程序
│   │   │   ├── alipay.md          # 支付宝小程序
│   │   │   ├── baidu.md           # 百度小程序
│   │   │   ├── bytedance.md       # 字节跳动小程序
│   │   │   ├── qq.md              # QQ小程序
│   │   │   └── kuaishou.md        # 快手小程序
│   │   ├── frameworks/            # 开发框架
│   │   │   ├── taro.md            # Taro框架
│   │   │   ├── uni-app.md         # uni-app框架
│   │   │   ├── remax.md           # Remax框架
│   │   │   └── chameleon.md       # Chameleon框架
│   │   ├── showcase/              # 案例展示
│   │   │   ├── index.md           # 案例首页
│   │   │   ├── ecommerce/         # 电商案例
│   │   │   ├── education/         # 教育案例
│   │   │   ├── games/             # 游戏案例
│   │   │   ├── tools/             # 工具案例
│   │   │   ├── lifestyle/         # 生活服务案例
│   │   │   └── business/          # 商务案例
│   │   ├── tools/                 # 开发工具
│   │   │   ├── index.md           # 工具首页
│   │   │   └── guides/            # 工具指南
│   │   ├── community/             # 社区
│   │   │   ├── index.md           # 社区首页
│   │   │   └── submit-project.md  # 项目提交
│   │   ├── data-storage.md        # 数据存储
│   │   ├── network-request.md     # 网络请求
│   │   ├── deployment.md          # 部署指南
│   │   └── ...                    # 其他文档
│   └── en/                        # 英文文档
│       ├── index.md               # 英文首页
│       ├── guide/                 # 开发指南(英文)
│       ├── platforms/             # 平台对比(英文)
│       ├── frameworks/            # 开发框架(英文)
│       ├── showcase/              # 案例展示(英文)
│       ├── tools/                 # 开发工具(英文)
│       ├── community/             # 社区(英文)
│       └── ...                    # 其他英文文档
├── package.json                   # 项目配置
├── package-lock.json              # 依赖锁定文件
├── .gitignore                     # Git忽略文件
└── README.md                      # 项目说明文档

🌐 多语言支持

本项目支持中英双语,采用VitePress的多语言配置:

  • 中文版本 - /zh/ 路径下的所有文档
  • 英文版本 - /en/ 路径下的所有文档
  • 自动切换 - 根据用户浏览器语言自动选择合适的语言版本
  • 导航同步 - 中英文导航结构保持一致,便于用户切换

语言切换

用户可以通过页面右上角的语言切换按钮在中英文之间自由切换,所有页面都有对应的翻译版本。

🎨 设计特色

视觉风格

  • 现代科技风格 - 深蓝色主题,专业学术氛围
  • 响应式布局 - 适配桌面、平板和移动设备
  • 卡片式设计 - 清晰的信息层次和交互反馈
  • 统一的品牌形象 - 专业的Logo和图标系统
  • 多语言界面 - 完整的中英文界面支持

技术特性

  • VitePress 1.6.3 - 基于Vue的静态站点生成器
  • Markdown内容 - 易于维护和更新的内容格式
  • SEO优化 - 完整的meta标签和结构化数据
  • 快速加载 - 优化的资源加载和缓存策略
  • 多语言路由 - 智能的多语言路由系统
  • 热重载 - 开发时的实时预览功能

📚 内容结构

开发指南

🚀 快速开始

  • 环境搭建 - 各平台开发工具安装配置
  • 第一个小程序 - Hello World到完整应用
  • 平台对比 - 各小程序平台特性和差异分析
  • 框架选择 - 根据项目需求选择合适的开发框架

🏗️ 基础开发

  • 项目结构 - 标准项目目录和文件组织
  • 配置文件 - app.json、页面配置、组件配置详解
  • 页面开发 - 页面生命周期、路由跳转、参数传递
  • 组件开发 - 自定义组件、组件通信、组件库使用
  • 数据绑定 - 数据流管理和状态同步
  • 事件处理 - 用户交互和事件响应

⚡ 进阶功能

  • API调用 - 网络请求、文件上传下载、支付集成
  • 数据存储 - 本地存储、云数据库、状态管理
  • 性能优化 - 代码分包、懒加载、内存管理
  • 设备能力 - 摄像头、定位、蓝牙、传感器等硬件调用
  • 安全防护 - 数据加密、权限管理、安全审计
  • 监控运维 - 性能监控、错误追踪、日志分析

🔄 跨平台开发

  • Taro开发实践 - React语法开发多端小程序
  • uni-app实战 - Vue语法一套代码多端部署
  • 平台适配 - 处理不同平台的API差异和UI适配
  • 构建优化 - 多平台构建配置和性能优化

🚀 发布部署

  • 代码审核 - 各平台审核规则和注意事项
  • 版本管理 - 灰度发布、版本回滚策略
  • 发布流程 - 从开发到上线的完整流程
  • 运营数据 - 用户分析、性能监控、错误追踪
  • CI/CD集成 - 自动化构建和部署流程

案例展示

我们精选了各个行业的优秀小程序案例:

  • 🛒 电商零售类 - 电商平台、社交电商、线下门店、生鲜配送
  • 🎓 教育学习类 - 在线课堂、语言学习、考试培训、单词学习
  • 🎮 游戏娱乐类 - 休闲游戏、社交游戏、教育游戏、益智游戏
  • 🔧 工具实用类 - 生活服务、日程管理、文件转换、智能记账
  • 🏥 生活服务类 - 餐饮服务、旅行服务、健康管理、预约服务
  • 💼 商务办公类 - 企业展示、客户管理、预约系统、办公协作

每个案例都包含:

  • 功能特性分析
  • 技术架构解析
  • 开发要点总结
  • 最佳实践建议
  • 源码参考链接

开发工具

🛠️ 官方开发工具

  • 微信开发者工具 - 集成IDE、调试器、性能分析器
  • 支付宝小程序开发者工具 - 支付宝生态专用开发环境
  • 百度开发者工具 - 智能小程序开发调试工具
  • 字节跳动开发者工具 - 今日头条系小程序开发工具

🎨 UI组件库

  • WeUI - 微信官方设计语言,原生体验
  • Vant Weapp - 有赞开源,组件丰富功能完整
  • TDesign - 腾讯开源企业级设计语言
  • NutUI - 京东风格的轻量级移动端组件库

🔧 开发辅助工具

  • 代码生成器 - 快速生成页面、组件模板
  • 样式转换器 - CSS到各平台样式语法转换
  • 图标工具 - 矢量图标库和字体图标生成
  • API Mock工具 - 接口模拟和数据生成

🧪 调试测试工具

  • 性能分析 - 启动时间、内存使用、渲染性能监控
  • 错误追踪 - 运行时错误收集和分析
  • 自动化测试 - 单元测试、集成测试、E2E测试
  • 真机调试 - 远程调试和日志查看

社区论坛

  • 新手问答 - 入门问题讨论区
  • 技术讨论 - 深度技术交流
  • 案例分享 - 作品展示和经验分享
  • 项目提交 - 优秀项目展示平台

🛠️ 开发指南

添加新页面

  1. 在相应语言目录下创建 .md 文件
  2. docs/.vitepress/config.ts 中添加导航配置
  3. 使用Markdown语法编写内容
  4. 确保中英文版本保持同步

多语言内容管理

# 添加中文页面
docs/zh/new-page.md

# 添加对应的英文页面
docs/en/new-page.md

# 在config.ts中配置导航
// 中文导航
{ text: '新页面', link: '/zh/new-page' }

// 英文导航
{ text: 'New Page', link: '/en/new-page' }

自定义样式

在Markdown文件中使用 <style> 标签添加自定义CSS:

<style>
.custom-class {
  /* 自定义样式 */
}
</style>

添加图片资源

  1. 将图片文件放入 docs/public/ 目录
  2. 在Markdown中使用相对路径引用:![描述](/image.svg)
  3. 建议使用SVG格式以获得更好的显示效果

配置检查

运行以下命令检查配置和链接:

# 检查构建
npm run build

# 检查链接有效性
npm run dev

🤝 贡献指南

我们欢迎社区贡献!请遵循以下步骤:

贡献流程

  1. Fork 本仓库到你的GitHub账号
  2. 创建特性分支:git checkout -b feature/amazing-feature
  3. 提交更改:git commit -m 'Add amazing feature'
  4. 推送分支:git push origin feature/amazing-feature
  5. 提交 Pull Request

贡献类型

  • 📝 文档改进 - 修正错误、补充内容、翻译优化
  • 🐛 Bug修复 - 修复网站问题、链接错误
  • 新功能 - 添加新的页面、功能或工具
  • 🎨 设计优化 - 改进用户界面和体验
  • 🌐 多语言支持 - 完善中英文翻译
  • 📊 案例补充 - 添加优秀的小程序案例

代码规范

  • 使用Markdown格式编写文档
  • 保持中英文内容同步
  • 遵循现有的文件命名规范
  • 添加适当的meta信息和SEO标签
  • 确保链接有效性

内容质量要求

  • 内容准确、实用、有价值
  • 代码示例可运行、有注释
  • 图片清晰、格式统一(推荐SVG)
  • 遵循平台的设计风格

📄 许可证

本项目采用 MIT 许可证

📞 联系我们

🔗 快速链接

官方平台文档

跨平台框架

开发工具下载

🏗️ 小程序技术架构

核心技术栈

  • 前端技术 - WXML/AXML、WXSS/ACSS、JavaScript/TypeScript
  • 框架层 - 各平台原生框架 + 跨平台解决方案
  • 运行时 - V8引擎、WebView、原生渲染引擎
  • 云服务 - 云函数、云数据库、云存储、CDN

开发生态

  • 开发工具 - IDE、调试器、模拟器、真机预览
  • 组件生态 - 官方组件 + 第三方组件库
  • 插件系统 - 功能插件、UI插件、工具插件
  • 社区资源 - 开源项目、技术文章、视频教程

性能优化

  • 启动优化 - 代码分包、预加载、缓存策略
  • 渲染优化 - 虚拟列表、图片懒加载、DOM优化
  • 内存管理 - 组件生命周期、内存泄漏防护
  • 网络优化 - 请求合并、数据缓存、CDN加速

📊 平台数据对比

平台 用户规模 主要场景 技术特色 生态优势 开发难度
微信小程序 10亿+ 社交、电商、生活服务 成熟稳定、功能完善 用户基数大、生态丰富 ⭐⭐⭐
支付宝小程序 7亿+ 金融、商业、政务 商业化能力强 支付场景优势 ⭐⭐⭐
百度智能小程序 5亿+ 搜索、信息、AI应用 AI能力丰富 搜索流量入口 ⭐⭐⭐⭐
字节跳动小程序 6亿+ 内容、娱乐、电商 算法推荐 内容分发优势 ⭐⭐⭐⭐
QQ小程序 8亿+ 社交、游戏、娱乐 年轻用户群体 QQ生态整合 ⭐⭐⭐
快手小程序 3亿+ 短视频、直播、电商 下沉市场覆盖 视频内容生态 ⭐⭐⭐⭐
飞书小程序 1000万+ 企业办公、协作工具 B端场景专业 企业服务生态 ⭐⭐⭐⭐
京东小程序 5亿+ 电商购物、供应链 电商场景深度 供应链优势 ⭐⭐⭐
小红书小程序 2亿+ 生活方式、种草分享 内容社区特色 消费决策影响 ⭐⭐⭐⭐

🔮 技术发展趋势

当前热点

  • 跨平台统一 - 一套代码适配多个小程序平台
  • 云原生架构 - Serverless、微服务、容器化
  • AI集成 - 智能客服、图像识别、语音处理
  • 性能优化 - 预加载、缓存策略、包体积优化
  • 低代码开发 - 可视化开发、拖拽式构建

未来方向

  • WebAssembly支持 - 高性能计算能力
  • AR/VR集成 - 沉浸式体验
  • IoT连接 - 物联网设备控制
  • 边缘计算 - 就近处理降低延迟
  • 5G应用 - 高速网络带来的新可能

技术演进

  • 框架成熟度提升 - 跨平台框架功能完善
  • 开发工具优化 - 更智能的IDE和调试工具
  • 生态系统完善 - 组件库、插件、工具链丰富
  • 标准化进程 - 各平台API趋向统一

📈 项目统计

  • 📄 文档页面: 100+ 页
  • 🌐 支持语言: 中文、英文
  • 📱 覆盖平台: 9大主流小程序平台
  • 🛠️ 开发框架: 4个主流跨平台框架
  • 📊 案例展示: 50+ 优质案例
  • 🔧 开发工具: 30+ 实用工具
  • 👥 社区活跃度: 持续更新中

🙏 致谢

感谢所有为小程序研究院贡献内容和代码的开发者们!

技术支持

  • VitePress - 优秀的静态站点生成器
  • Vue.js - 渐进式JavaScript框架
  • Node.js - 高性能JavaScript运行时

平台支持

  • 微信小程序团队 - 提供强大的小程序平台和丰富的API
  • 支付宝小程序团队 - 商业化场景的深度支持
  • 百度智能小程序团队 - AI能力和搜索生态整合
  • 字节跳动小程序团队 - 内容分发和算法推荐能力
  • QQ小程序团队 - 年轻用户群体的社交生态
  • 快手小程序团队 - 短视频和直播生态支持

开源社区

  • Taro团队 - 跨平台开发框架的创新
  • uni-app团队 - 多端统一开发解决方案
  • 各UI组件库维护者 - 提供优秀的组件和设计规范
  • 广大开发者 - 分享经验、贡献代码、完善生态

特别感谢

  • 内容贡献者 - 提供优质的技术文章和案例
  • 翻译志愿者 - 完善多语言支持
  • 测试用户 - 提供宝贵的反馈和建议
  • 设计师 - 提供专业的UI/UX设计支持

小程序研究院 - 让小程序开发更简单 🚀

最后更新时间: 2024年1月

About

小程序研究院

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published