MapStudioMapLibre 样式可视化编辑器

三分钟上手 ​

git clone <repo> && cd mapstudio2/editor
npm install --legacy-peer-deps   # peer 冲突是备案已知项，CI 同款
npm run dev                      # 打开 http://localhost:4230

起来之后是一个三栏工作台：左边图层树、中间地图画布、右边属性面板。离线也能完整体验——底图拉取失败会自动回退内置离线演示样式。想确认环境完全就绪，再跑三条最小门禁：

npm run typecheck   # tsc 0 错
npm test            # vitest 全量 223 文件 4610 例
npm run build       # 生产构建 → dist/

三绿即环境就绪。中间任何一步卡住，直接查常见问题。

本站是什么 ​

本站（docs-site/，VitePress）是 MapStudio 仓库的唯一权威文档入口。仓库里的文档权威分两类：指南和参考页由本站承载；进度台账、架构铁律原文、领域规格这些"活文档"原地留在仓内（docs/notes/roadmap.md、editor/docs/refactor/ARCHITECTURE-RULES.md、docs/spec/），它们被代码注释和 CI 测试锚定，不搬动。两类的边界登记在文档地图，同一份事实出现在两处维护即违规。

建议阅读路径 ​

• 上手使用：从零开始起环境，功能全景过一遍能力面，卡住查常见问题。
• 理解设计：先看技术选型和设计原则建立判断框架，再读架构总览（重头戏，数据流、表达式内核、撤销栈、双档模型逐域拆解），定位文件配目录职责。
• 动手开发：开发规范和测试策略读完再写代码；第一次提交前过参与指南的清单；想安全地做重构，看演进指南和决策记录。

本站内容与代码不一致时，以代码、配置和测试为准，并回改本站。