MineMap 全局配置、key/solution、域名地址、sprite/fonts、minemapCDN 与启动前配置顺序。用于指导用户正确完成地图初始化前的配置，不再把 accessToken 作为主推荐路径。
MineMap 全局配置、key/solution、域名地址、sprite/fonts、minemapCDN 与启动前配置顺序。用于指导用户正确完成地图初始化前的配置，不再把 accessToken 作为主推荐路径。
npx skills add https://github.com/ming1zhou88/minemap-skills --skill minemap-global-configuration复制此命令并粘贴到 Claude Code 中以安装该技能
| name | minemap-global-configuration |
| description | MineMap 全局配置、key/solution、域名地址、sprite/fonts、minemapCDN 与启动前配置顺序。用于指导用户正确完成地图初始化前的配置，不再把 accessToken 作为主推荐路径。 |
// 先配全局，再创建第一个 Map
minemap.domainUrl = "https://minedata.cn";
minemap.dataDomainUrl = "https://minedata.cn";
minemap.serverDomainUrl = "https://minedata.cn";
minemap.spriteUrl = "https://minedata.cn/minemapapi/sprite/latest/sprite";
minemap.serviceUrl = "https://minedata.cn/service/";
minemap.key = "<替换成你的 key>";
minemap.solution = 11001;
window.minemapCDN = "https://minedata.cn/minemapapi/minemap-CDN";
const style = {
version: 8,
glyphs: "minemap://fonts/{fontstack}/{range}",
sprite: "minemap://sprite/sprite",
sources: {},
layers: []
};
const map = new minemap.Map({
container: "map",
style,
center: [116.46, 39.92],
zoom: 12
});
source/index.js 暴露的全局配置入口MineMap 把一批启动配置直接挂在 minemap 顶层对象上。
当前源码能确认的主要入口有：
minemap.keyminemap.solutionminemap.domainUrlminemap.dataDomainUrlminemap.serverDomainUrlminemap.serviceUrlminemap.spriteUrlminemap.fontsUrlminemap.dataVersion兼容入口仍然存在，但不再作为主推荐：
minemap.appKeyminemap.accessToken另外，很多 3D / worker 相关 demo 还会显式设置：
window.minemapCDNkey + solution，不要再把 accessToken 当主方案source/util/urlTransformUtil.js 的真实优先级是：
keykey 再用 appKeyaccessToken也就是：key > appKey > accessToken
而仓库里的 demo，绝大多数也都在顶部配置：
minemap.key = ...minemap.solution = ...因此这套 skill 的推荐是：
keysolutionappKey 只作为兼容或某些旧服务/显式 URL 场景的补充accessToken 作为默认推荐写法Map 之前配置这些全局值会参与 MineMap 内部的 URL 组装、样式资源解析和服务请求拼接。
如果先 new minemap.Map(...)，再去补这些配置，常见后果是：
所以正确顺序是：
Mapload / style.load 后续逻辑minemap.key主推荐鉴权参数。MineMap 在内部拼装 URL 时，会优先把它写成 key=...。
minemap.solution方案 ID。内部会按 solu=... 拼进请求参数。只要你的底图、样式、服务能力和某个方案绑定，就应该一起配。
minemap.domainUrl静态资源根域配置。source/index.js 的 setter 不只是简单赋值，还会联动重算：
SRC_URLSERVICE_URL而且它会把传入地址拆成“域名 + 资源前缀”两部分，所以它既可以接纯域名，也能接带资源路径的地址。
minemap.dataDomainUrl数据域配置。setter 会联动更新：
API_URLDYN_URLMERGE_URLOTHER_URL源码支持字符串，也支持数组。
适合：
minemap.serverDomainUrl分析/服务域配置。setter 会联动更新 SERVER_URL，同样支持字符串或数组。
minemap.serviceUrl直接覆盖服务根地址。很多 demo 都显式设置它，用来明确 style / service 请求走哪个服务域。
minemap.spriteUrl雪碧图覆盖地址。source/style/loadSprite.js 表明，它会和 style 里的 sprite 一起参与解析，而且配置项优先级很高。
源码还支持：
数组模式可用于多 sprite 源。
minemap.fontsUrl字形资源覆盖地址。不是每个 demo 都配，但源码和 VectorMap2.1.html 表明这是合法入口，适合旧字体服务或私有字体服务迁移。
minemap.dataVersion内部会转成请求参数 version=...。适合和数据发布版本联动。
window.minemapCDN这不是 minemap 顶层 getter/setter，但对 3D / worker 资源非常关键。
源码里 loaders.gl worker 和 CDN 选项都会读取它。没配时，很多 3D demo 的 worker 资源路径就不稳定。
仓库里大量 demo 都是这一段结构：
minemap.domainUrl = "https://minedata.cn";
minemap.dataDomainUrl = "https://minedata.cn";
minemap.serverDomainUrl = "https://minedata.cn";
minemap.spriteUrl = "https://minedata.cn/minemapapi/sprite/latest/sprite";
minemap.serviceUrl = "https://minedata.cn/service/";
minemap.key = "...";
minemap.solution = 11001;
window.minemapCDN = "https://minedata.cn/minemapapi/minemap-CDN";
如果你是不知道“到底要配哪些字段”，先按这个最小模板起步，通常最稳。
如果你自己传的是空 style：
const style = {
version: 8,
glyphs: "minemap://fonts/{fontstack}/{range}",
sprite: "minemap://sprite/sprite",
sources: {},
layers: []
};
那通常还是建议把下面几项先配好：
keysolutiondomainUrldataDomainUrlserverDomainUrlspriteUrl因为后面你很可能还是会加 source、layer、image、scene component。
只要页面里有：
3d-model3d-tiles就建议把 window.minemapCDN 一起配上。
这是 3D demo 中最常见的补充项之一。
VectorGeojsonOverlap.html 证明 minemap.spriteUrl 可以直接给数组：
minemap.spriteUrl = ["https://host-a/sprite/sprite", "https://host-b/sprite/sprite"];
适合：
VectorMap2.1.html 证明可以单独配置：
minemap.fontsUrl = "https://your-host/fonts";
适合：
用户最容易卡住的，其实不是 Map 参数，而是“前面那段全局配置到底怎么写”。
建议直接看 demo 页面最上方的初始化段，通常就在创建 Map 之前。
优先参考这些页面：
demo/html/3DTiles.htmldemo/html/3DTilesLoaded.htmldemo/html/3DModelViewer.htmldemo/html/ExtrusionLightStripScanning.htmldemo/html/VectorMap2.1.htmldemo/html/3DTilesOpacity.html观察重点不是抄整页代码，而是看这几个字段：
domainUrldataDomainUrlserverDomainUrlspriteUrlserviceUrlkeysolutionwindow.minemapCDN仓库里有两种情况：
<您的 key> / <your key> 占位正确理解是：
new Map()，后补全局配置这是最常见错误。
MineMap 的资源 URL 和样式资源解析很多都是启动早期就发生的。后补配置，通常来不及。
accessToken 当主推荐方案源码虽然还保留 accessToken，但当前真实优先级已经是：
keyappKeyaccessToken而且当前 demo 主流也不是这么写。
所以不要再把它当主教程入口。
domainUrl，不配 dataDomainUrl / serverDomainUrl在私有化、分域部署、服务域拆分场景里，这会导致：
window.minemapCDN很多 2D 页面不一定会立刻暴露这个问题，但 3D / worker 相关场景非常容易踩坑。
spriteUrl 和 style 内 sprite 配置混着改，却不知道谁生效loadSprite.js 的逻辑说明：全局 minemap.spriteUrl 会介入 sprite 解析。
如果你全局已覆盖，就不要一边指望 style 里的 sprite 生效，一边再全局强覆盖，最后自己也分不清实际请求地址。
appKeyappKey 不是不能用，但它更适合：
主配置入口还是优先 key。
如果你要给别人一段“先跑起来”的 MineMap 配置模板，优先给这套：
minemap.domainUrl = "https://minedata.cn";
minemap.dataDomainUrl = "https://minedata.cn";
minemap.serverDomainUrl = "https://minedata.cn";
minemap.spriteUrl = "https://minedata.cn/minemapapi/sprite/latest/sprite";
minemap.serviceUrl = "https://minedata.cn/service/";
minemap.key = "<你的 key>";
minemap.solution = 11001;
window.minemapCDN = "https://minedata.cn/minemapapi/minemap-CDN";
然后再根据项目情况增量调整：
fontsUrldataDomainUrl 数组spriteUrl 数组dataVersiondemo/html/3DTiles.htmldemo/html/3DTilesLoaded.htmldemo/html/3DTilesOpacity.htmldemo/html/3DModelViewer.htmldemo/html/ExtrusionLightStripScanning.htmldemo/html/VectorGeojsonOverlap.htmldemo/html/VectorMap2.1.htmlminemap-fundamentalsminemap-style-systemminemap-style-and-dataminemap-scene-componentsminemap-performance-and-backendMineMap 二三维叠加规范。覆盖矢量贴地、贴模型、对象接受/拒绝贴合、symbol 自动赋高、以及 raster 深度测试与图层顺序控制。
MineMap 的 Marker 与 Popup 规范。涵盖 DOM 覆盖物、三维高度、distanceDisplayCondition、拖拽、内容 API、地形场景与常见失败场景。
MineMap 模型运行时调试规范。用于爆炸视图、材质/纹理更新、线框显示、属性外挂、运行时查看与距离可见性控制。
MineMap 三维场景组件体系：SceneModel、SceneTileset、SceneObject（Earth/Skybox/AirLine 等），重点补全 glTF/glb 与 3D Tiles 参数边界。
MineMap 样式规范（style v8）、source/layer 管理、图标资源、GeoJSON 更新与数据源组织，重点补全 VectorTileSource 参数与约束。
MineMap 地形设置（setTerrain）、DEM 高程查询、地形分析、TerrainLeveling、相机碰撞高度与 terrain 相关约束。