CDN引入失败应优先加onerror降级逻辑并锁定版本号；常见原因包括网络策略拦截、file://协议限制、路径错误及未锁定版本导致运行时崩溃，须用本地服务运行并验证URL有效性。
CDN引入第三方库时加载失败怎么办
CDN引入最常见问题不是样式错乱或功能异常，而是直接白屏或控制台报 net::ERR_CONNECTION_TIMED_OUT、Failed to load resource。这通常不是代码写错了，而是网络策略导致的——比如国内访问 unpkg.com 或 jsdelivr.net 不稳定，某些企业内网还会拦截境外域名。
解决思路不是换库，而是加降级逻辑：
- 用
onerror属性触发备用加载：<script src="https://cdn.jsdelivr.net/npm/vue@3.4.21/dist/vue.global.js" onerror="this.src='js/vue.global.js'"></script> - 确保本地路径
js/vue.global.js确实存在，且是未压缩的开发版（便于调试） - 避免多个
onerror嵌套：一个 script 标签只配一个降级目标，否则容易陷入死循环 - 不要在
onerror里写document.write，现代浏览器已禁用该方法
本地引入时路径 404 的典型原因和修复方式
本地引入报 net::ERR_FILE_NOT_FOUND 或 Failed to load module script，90% 是路径问题，而不是文件没放对。关键在于 HTML 文件运行时的“当前工作目录”不等于你想象的根目录。
常见陷阱：
立即学习“前端免费学习笔记（深入）”；
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
- 双击打开 HTML 文件走的是
file://协议，Chrome 会禁止加载本地<script></script>（安全策略），必须用http://localhost:8080启动本地服务 -
./js/vue.js是相对当前 HTML 所在路径，如果 HTML 在/pages/index.html，那它会去找/pages/js/vue.js，而非项目根目录下的/js/vue.js - 推荐统一用根相对路径：
/js/vue.js（开头带/），前提是用本地 server 启动，且项目结构支持 - 检查浏览器开发者工具 Network 面板里请求的完整 URL，比猜路径更可靠
CDN 版本号不锁定引发的运行时崩溃
写成 https://cdn.jsdelivr.net/npm/vue@3/dist/vue.global.js 看似省事，实际非常危险。Vue 从 v3.4 升到 v3.5 时，createApp 的参数签名变了；Chart.js 从 v4.4 升到 v4.5，plugins.legend.labels.generateLabels 返回值结构被调整。这些都不是“兼容更新”，而是运行时直接报 TypeError。
生产环境必须显式锁定版本：
- 主版本锁定（推荐）：
vue@3→ 只匹配 v3.x，不升 v4 - 完整版本锁定（最稳）：
vue@3.4.21→ 精确到 patch 版本 - 绝对不要用
vue@latest，它可能某天指向 v4，而你的代码完全没适配 - 检查 CDN 页面（如 jsDelivr 的包页）确认该版本确实存在对应构建产物（比如
vue.global.js）
混合使用 CDN 和本地资源时的全局污染风险
一个页面同时有 <script src="https://cdn.jsdelivr.net/npm/lodash@4.17.21/lodash.min.js"></script> 和 <script src="js/lodash.js"></script>，不是“多加载一次”，而是可能造成 window._ 被覆盖两次，第二次执行时内部模块缓存失效，_.debounce 返回 undefined。
规避方式很务实：
- 先检测全局变量是否存在：
if (!window._) { document.write('...') }，但仅限简单脚本 - 更可靠的做法是只保留一种引入方式，开发阶段用本地未压缩版，构建后统一替换成 CDN 锁定链接
- 如果必须共存（如 A/B 测试），用
import()动态加载 +async/await控制顺序，避免竞态 - 注意 UMD vs IIFE 构建产物差异：CDN 上的
lodash.min.js多数是 IIFE，会无条件挂载_；而本地下载的lodash.js若是 ESM 格式，则不会自动污染全局
真正麻烦的从来不是“怎么引”，而是引完之后没人检查它是否在所有目标环境里都按预期加载了——尤其是弱网、内网、老旧浏览器这些场景，CDN 的“快”和本地的“稳”之间，差的往往就是一行 onerror 和一个带版本号的 URL。
