JavaScript 公共main.js适配多目录页面的统一资源URL实现方法
完全可以实现统一地址适配,不需要逐页改路径
只要放弃“依赖当前页面路径解析资源”的写法,换成基于脚本自身位置、或者项目固定根路径推导资源地址的逻辑,就能覆盖所有不同目录层级的页面,不用给每个页面单独做路径适配。
具体实现方式
方案1:基于main.js自身位置动态推导(通用零改造成本)
因为你的main.js固定存放在/js/目录下,不管引用它的页面在哪个目录层级,我们都可以通过DOM API拿到main.js本身的文件位置,顺着这个位置推导项目根目录,再拼接资源路径——这个逻辑完全不依赖当前页面的所在路径,永远不会出错。
直接把下面这段代码放到main.js的最开头就行:
// 获取当前main.js脚本的完整线上访问地址 const currentScript = document.currentScript.src; // 因为main.js固定在/js/目录下,匹配掉脚本路径末尾的/js/main.js,就能拿到项目根路径 const rootPath = currentScript.replace(/\/js\/main\.js$/, '/'); // 后续所有资源路径统一基于推导出来的根路径拼接 var myImgUrl = `${rootPath}img/thisPicture.png`;
这个方案的优势:
- 不管后续页面新增多少层级、放在多深的目录下,只要还是引用同一份
/js/main.js,路径推导就不会失效 - 不需要改动任何HTML页面的现有代码,只需要调整main.js内部的路径生成逻辑
- 完全规避了页面目录变化导致的相对路径错位问题
方案2:固定根常量配置(适合部署路径固定的项目)
如果你的项目部署位置是固定的,不会随便切换根目录,那写法可以更简单:直接在main.js开头定义全局根路径常量,所有资源地址统一拼接这个常量前缀即可。
// 定义全局项目根路径,根据实际部署场景调整 const ROOT_URL = '/'; // 统一拼接资源地址 var myImgUrl = `${ROOT_URL}img/thisPicture.png`;
这种写法的适配场景:项目确定部署在域名根目录,或者固定在某级子路径下,没有频繁调整部署位置的需求时,代码简洁易维护。
避坑提醒
- 不要在main.js里写不带斜杠开头的裸相对路径,比如
var myImgUrl = "img/thisPicture.png":这种路径的解析基准是当前打开的页面URL,不是main.js的位置,在bio、activities这些子目录的页面里,浏览器会把路径自动解析成对应子目录下的img文件夹,必然加载失败 - 不推荐依赖
<base>标签做统一路径配置:这个标签会重写页面里所有相对路径的解析规则,很容易和页面里原本已经适配好的相对路径产生冲突,排查问题的成本很高
内容的提问来源于stack exchange,提问作者Fabio Manniti
相关产品推荐
相关产品推荐

