本地文件双击打开会触发CORS限制，需用HTTP服务（如python3 -m http.server）访问；DevTools可模拟弱网和设备；需启用source map调试；静态资源路径要匹配部署子路径。

本地文件直接双击打开会触发 CORS 限制

HTML5 页面如果包含 fetch、XMLHttpRequest 或 importScripts 等跨源请求，用文件协议（file://）直接双击打开，浏览器会因安全策略拒绝加载资源——这不是代码写错了，是协议本身被拦了。

• Chrome / Edge 默认禁止 file:// 下的 AJAX 请求；Firefox 行为稍宽松但也不稳定
• 本地测试必须启动一个最小 HTTP 服务，哪怕只是临时的
• 推荐用命令行快速起服务：

  python3 -m http.server 8000

  （Python 3）或

  npx http-server -p 8000

  （需 Node.js）
• 然后访问 http://localhost:8000/index.html，CORS 问题立刻消失

用 Chrome DevTools 模拟真实弱网与移动端设备

上线前不测网络降级和小屏适配，等于把 bug 直接交给用户发现。DevTools 的 Network 和 Device Toolbar 不是摆设，得真用。

• 在 DevTools 中按 Cmd+Shift+P（Mac）或 Ctrl+Shift+P（Win/Linux），输入 Network conditions 回车，勾选 Offline 或选 Slow 3G 模拟卡顿
• 点顶部工具栏的 Toggle device toolbar（快捷键 Ctrl+Shift+M），选 iPhone SE 或 Nexus 5X 看响应式是否断裂
• 特别注意：viewport meta 标签是否漏写？ 缺失会导致移动端页面缩放异常

检查控制台报错不能只看红字，要盯住 source map 和堆栈源头

压缩后的 JS 报错常显示 app.min.js:2:12345，这种定位毫无意义。上线前必须确认 sourcemap 是否生成且路径正确，否则调试等于盲人摸象。

• Webpack/Vite 用户检查构建配置中 devtool 是否设为 source-map（生产环境可设 hidden-source-map，配合错误监控平台使用）
• 确保生成的 .map 文件与 JS 同目录，且 JS 文件末尾有注释行：//# sourceMappingURL=app.js.map
• Chrome 控制台右上角三个点 → Settings → Preferences → Sources → Enable JavaScript source maps 必须勾选
• 遇到 Uncaught TypeError: Cannot read property 'xxx' of undefined，别急着改代码，先点堆栈里带 .ts 或 .jsx 的那一行，看原始源码位置

静态资源路径错位是上线后白屏/样式丢失的头号原因

开发时用 /static/logo.png 能显示，上线部署到子路径如 https://example.com/my-app/ 就 404——因为 /static/ 被解析成根目录，实际资源在 /my-app/static/ 下。

立即学习“前端免费学习笔记（深入）”；

• Vite 用户检查 vite.config.ts 中 base 配置：base: '/my-app/'（结尾带斜杠）
• Webpack 用户检查 output.publicPath，值必须与部署路径一致
• HTML 中所有相对路径尽量用 统一基准，避免零散写死 ./ 或 /
• 用 curl -I https://example.com/my-app/static/main.css 实测资源能否返回 200，比肉眼刷新网页更可靠

真正卡住上线的，往往不是语法错误，而是路径、协议、构建配置这三处的隐性不一致。每个环节都得用真实请求验证，而不是依赖“看起来正常”。

# css  # linux  # javascript  # python  # java  # html  # js  # node.js 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： Laravel如何理解并使用服务容器（Service Container）_Laravel依赖注入与容器绑定说明  如何选择PHP开源工具快速搭建网站？  如何选择可靠的免备案建站服务器？  Laravel如何安装Breeze扩展包_Laravel用户注册登录功能快速实现【流程】  Laravel怎么做数据加密_Laravel内置Crypt门面的加密与解密功能  详解免费开源的DotNet二维码操作组件ThoughtWorks.QRCode（.NET组件介绍之四）  Android滚轮选择时间控件使用详解  Laravel如何处理和验证JSON类型的数据库字段  Windows10怎样连接蓝牙设备_Windows10蓝牙连接步骤【教程】  微信小程序 五星评分(包括半颗星评分)实例代码  胶州企业网站制作公司,青岛石头网络科技有限公司怎么样？  大连企业网站制作公司,大连2025企业社保缴费网上缴费流程？  Laravel Pest测试框架怎么用_从PHPUnit转向Pest的Laravel测试教程  Laravel如何获取当前用户信息_Laravel Auth门面获取用户ID  如何在IIS管理器中快速创建并配置网站？  成都品牌网站制作公司,成都营业执照年报网上怎么办理？  Laravel如何清理系统缓存命令_Laravel清除路由配置及视图缓存的方法【总结】  利用vue写todolist单页应用  如何续费美橙建站之星域名及服务？  电商网站制作多少钱一个,电子商务公司的网站制作费用计入什么科目？  iOS UIView常见属性方法小结  绝密ChatGPT指令：手把手教你生成HR无法拒绝的求职信  Laravel如何实现全文搜索功能？（Scout和Algolia示例）  Laravel怎么调用外部API_Laravel Http Client客户端使用  百度输入法ai组件怎么删除 百度输入法ai组件移除工具  如何快速搭建虚拟主机网站？新手必看指南  简单实现jsp分页  Laravel软删除怎么实现_Laravel Eloquent SoftDeletes功能使用教程  实例解析angularjs的filter过滤器  Swift开发中switch语句值绑定模式  大连 网站制作,大连天途有线官网？  ,南京靠谱的征婚网站？  Claude怎样写结构化提示词_Claude结构化提示词写法【教程】  个人摄影网站制作流程,摄影爱好者都去什么网站？  php8.4header发送头信息失败怎么办_php8.4header函数问题解决【解答】  Laravel如何处理JSON字段_Eloquent原生JSON字段类型操作教程  C#如何调用原生C++ COM对象详解  高防服务器租用如何选择配置与防御等级？  Laravel PHP版本要求一览_Laravel各版本环境要求对照  iOS正则表达式验证手机号、邮箱、身份证号等  JavaScript 输出显示内容(document.write、alert、innerHTML、console.log)  浅述节点的创建及常见功能的实现  如何基于PHP生成高效IDC网络公司建站源码？  Laravel的Blade指令怎么自定义_创建你自己的Laravel Blade Directives  如何快速搭建高效可靠的建站解决方案？  Android中Textview和图片同行显示(文字超出用省略号，图片自动靠右边)  ChatGPT回答中断怎么办 引导AI继续输出完整内容的方法  Laravel如何实现多级无限分类_Laravel递归模型关联与树状数据输出【方法】  EditPlus 正则表达式 实战(3)  javascript中闭包概念与用法深入理解