根本原因是webview或本地服务器未建立url路径到文件系统的映射规则：file://协议受严格限制，http服务器不支持自动重写，electron的loadfile导致路径解析基准错乱，需按环境配置对应映射机制。
混合开发中 HTML 无法加载本地资源（如 js、css、images），根本原因不是路径写错了，而是 WebView 或本地服务器未将请求映射到真实文件系统路径——浏览器看到的是 file:// 或 http://localhost:xxxx，但资源实际在项目目录某处，中间缺一层“映射规则”。
WebView 加载本地 HTML 时图片/CSS 不显示
这是最典型的现象：HTML 文件用相对路径引用 ./assets/style.css，在 Chrome 里打开正常，但在 Android WebView 或 iOS WKWebView 中空白或报 404。因为 WebView 默认不启用本地文件系统访问，且对 file:// 协议有严格限制（比如禁止跨目录读取、禁用 fetch、CORS 阻断）。
- Android 需显式启用：
webView.getSettings().setAllowContentAccess(true)和setAllowFileAccess(true)（仅限调试，上线必须禁用） - iOS WKWebView 默认禁止
file://加载非同目录资源；必须用loadFileURL:allowingReadAccessToURL:指定可读根路径，例如指向mainBundle.bundleURL的父级 - 更稳妥的做法是不走
file://，改用内置 HTTP 服务：Android 可集成android-async-http起一个微型 server；iOS 可用GCDWebServer，把项目根目录设为 document root
VS Code Live Server 导致 JS 无法请求本地 JSON
你在 index.html 里写了 fetch('./data/config.json')，用 VS Code Live Server（http://127.0.0.1:5500）打开时控制台报 CORS 错误或 404。Live Server 是静态服务器，它只按 URL 路径映射文件，但不会自动处理别名、重写或虚拟路径。
- 确认
config.json确实放在与index.html同级的./data/目录下，路径大小写必须完全一致（macOS/Linux 区分） - Live Server 不支持
.htaccess或 Nginx 式的rewrite；若想把/api/config映射到./data/config.json，得换工具——比如用serve（npx serve -s）配合rewrites配置，或直接切到 Vite（vite.config.js中用server.rewrite） - 开发阶段临时绕过：把 JSON 改成 JS 模块导出，用
import config from './data/config.js'，由构建工具处理，不走 HTTP 请求
Electron 中 window.location.href 跳转后资源 404
你用 win.loadFile('src/index.html') 启动主窗口，页面内点击链接跳转到 pages/settings.html，结果 CSS 和图标全丢。Electron 的 loadFile 是基于 file:// 协议加载，所有相对路径都以该 HTML 所在磁盘路径为基准解析——但 pages/settings.html 的 ./css/app.css 实际被解析为 file:///full/path/to/pages/css/app.css，而真实路径可能是 file:///full/path/to/src/css/app.css。
- 绝对路径不起作用：
href="css/app.css"和href="/css/app.css"在file://下行为不一致；后者会被解析为磁盘根目录，基本必错 - 正确做法：统一用
win.loadURL('http://localhost:3000')启动，并配一个本地 dev server（Vite/Electron Forge 内置），让所有路径走 HTTP，避免file://解析歧义 - 如果坚持用
loadFile，必须确保所有子页面的资源路径都相对于src/目录；推荐用构建脚本把pages/内容复制进src/，或用path.resolve(__dirname, '../src/css/app.css')动态生成base标签
真正难的不是写对路径，而是厘清当前运行环境到底用什么协议、谁在解析路径、映射规则由谁控制——WebView、Live Server、Electron、Vite，每个环境的“重定向映射”机制都不同，且多数不透明。别依赖浏览器地址栏显示的 URL 去猜路径，先查文档确认该环境是否支持路径重写，再决定是改构建流程、换启动方式，还是加一层代理。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
