ArcGIS for JavaScript CDN 资源全汇总

一、官方核心 CDN 资源（推荐优先使用）

1. 4.x 版本核心 API（主流版本）

支持 AMD 模块规范，包含地图渲染、空间分析等核心功能，需搭配样式表使用：

<!-- 样式表（支持light/dark主题切换） -->

<link rel="stylesheet" href="https://js.arcgis.com/4.33/esri/themes/light/main.css">

<!-- 核心API脚本（4.33为当前搜索结果中最新稳定版） -->

<script src="https://js.arcgis.com/4.33/"></script>

• 版本说明：可替换版本号（如 4.32、4.27、4.11 等）适配不同需求，版本变更仅需修改 URL 中的数字部分。

• 优势：通过全球 CDN 加速，无需本地构建，24/7 负载均衡保障可用性。

2. 3.x 版本兼容资源（ legacy 项目）

针对未升级的旧项目，API 结构与 4.x 存在差异：

<link rel="stylesheet" href="https://js.arcgis.com/3.46/esri/css/esri.css">

<script src="https://js.arcgis.com/3.46/"></script>

• 注意事项：3.x 版本的 Web Optimizer 工具已停用，自定义构建资源将于 2022 年 7 月后失效，建议迁移至 4.x。

3. ES Modules 形式（开发原型推荐）

支持模块化导入，适用于现代前端工程化开发（仅推荐开发环境使用）：

<link rel="stylesheet" href="https://js.arcgis.com/4.27/@arcgis/core/assets/esri/themes/light/main.css">

<script type="module">

  import Map from "https://js.arcgis.com/4.27/@arcgis/core/map.js";

  // 编写业务逻辑

</script>

• Next 版本资源：预发布版本可通过 jsDelivr 获取，如 4.19.0-next 版本的样式表：

@import "https://cdn.jsdelivr.net/npm/@arcgis/core@4.19.0-next.20210324/assets/esri/themes/light/main.css";

二、常见问题解决

• 跨域问题：官方 CDN 已配置 CORS，无需额外处理；自建镜像需确保服务端允许跨域请求

• 样式丢失：检查样式表与 API 版本是否一致，4.x 版本需使用esri/themes/[light/dark]/main.css路径，而非 3.x 的esri/css/esri.css

• 加载缓慢：优先选择就近 CDN 节点，避免同时引入多个版本 API