Skyline Overview

This is your go-to reference when evaluating or migrating to Skyline, WeChat's newer rendering engine that splits rendering onto a separate thread. It covers the architectural differences from WebView (66% faster first screen, no 10-page stack limit), the mandatory configs like custom navigation bars and lazy code loading, and a practical migration checklist. The MUST/NEVER rules are honest about the breaking changes, like how you can't use native navigation or rely on Page.onPageScroll anymore. Good starting point before you commit to a migration, with clear pointers to deeper docs on WXSS support, Worklet animations, and performance tuning.

skills.sh installs: 1.1K
GitHub stars: 56
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add wechat-miniprogram/skyline-skills --skill skyline-overview --agent claude-code

Installs into .claude/skills of the current project.

Files

Skyline 渲染引擎概览

适用场景

初次了解 Skyline 渲染引擎
评估是否迁移到 Skyline
查看 Skyline 版本更新日志
了解与 WebView 的差异和兼容性
获取迁移步骤和最佳实践

核心概念

Skyline 是什么？

Skyline 是微信小程序的新一代渲染引擎，相比 WebView 有以下优势：

对比项	WebView	Skyline
渲染线程	与 JS 逻辑同线程	独立渲染线程
页面内存	每页一个 WebView	共享渲染实例
首屏性能	较慢	快 66%+
光栅化	异步分块	同步（无白屏）
页面栈限制	最多 10 层	无限制（连续 Skyline 页面）

环境要求

平台	最低版本	基础库版本
Android	微信 8.0.40+	3.0.2+
iOS	微信 8.0.40+	3.0.2+
HarmonyOS	微信 1.0.10+	3.11.3+
开发者工具	Stable 1.06.2307260+	-

快速开始配置

必需配置（app.json）

{
  "renderer": "skyline",
  "lazyCodeLoading": "requiredComponents",
  "componentFramework": "glass-easel",
  "rendererOptions": {
    "skyline": {
      "defaultDisplayBlock": true,
      "defaultContentBox": true,
      "tagNameStyleIsolation": "legacy",
      "enableScrollViewAutoSize": true,
      "keyframeStyleIsolation": "legacy"
    }
  }
}

页面配置（page.json）

{
  "navigationStyle": "custom",
  "disableScroll": true
}

⚠️ MUST: Skyline 不支持原生导航栏，必须设置 navigationStyle: custom 并自行实现导航栏。

文档索引

SKILL.md on GitHub

Details

Repository: github.com/wechat-miniprogram/skyline-skills
First seen: Jun 3, 2026

More from wechat-miniprogram/skyline-skills

All 7