迅睿CMS文件引入报错

你是不是刚改完迅睿CMS的模板，加了自定义css或者js文件，一刷新前台，要么整个页面空白，要么开发者工具红通通一片报错，找了一下午都摸不着头脑？

我上周才帮一个做本地装修站的粉丝解决这个问题，他就加了个轮播图的js，结果整个首页直接挂了，差点把他服务器给折腾重启了。

其实迅睿CMS文件引入报错，90%都是几个小问题，根本不是什么复杂的系统bug，今天把我积累的解决步骤给你，一步一步对着来，5分钟就能搞定。

1. 路径写错了，这是最高发的原因

超过九成的报错都出在这，别不信，你自己对着查一遍。

1.1 硬写路径，搞混相对绝对路径

很多新手刚用迅睿，不知道有内置路径变量，直接自己硬写路径。

举个例子，你模板放在服务器的templates/你的模板名文件夹里，你硬写../css/style.css，换个环境就错。

其实迅睿早就给你写好变量了，正确引入写法是这样：

``` ```

避坑提醒：不要把assets文件夹放根目录硬写死路径，用内置变量不管放哪个服务器都不会错。

1.2 文件名大小写不匹配

这个坑我刚用迅睿的时候踩过，太坑人了。

你本地Windows系统不区分大小写，你文件叫Style.css，写style.css也能打开。

传到服务器用Linux系统，人家严格区分大小写，直接给你报404找不到。

解决方法也简单，所有文件统一改成小写，写引入代码直接复制文件名，别手敲出错。

2. 权限或者目录不对，服务器不让访问

路径改对了还是报错？那大概率是服务器这边不让读你的文件。

2.1 文件权限设置错误

很多新手用ftp传文件，默认权限可能设成了700，只有管理员能读。

服务器的web服务读不了，就会报403错误，看起来就是文件引入报错。

具体操作：打开你的服务器面板，找到对应文件，单个文件权限改成644，存放文件的目录改成755。

避坑提醒：别图省事全改成777权限，虽然能用，但不安全，容易被黑客挂马。

2.2 文件放错了系统目录

迅睿默认禁止访问系统保护目录里的静态文件，比如config、cache这些目录。

你把js文件放cache里，不管你路径写的多对，都访问不了，直接报错。

记住：所有你自己加的css、js、图片，都放在模板目录下的assets文件夹，别乱放。

3. 缓存没清，系统还在读旧文件

明明改对了，刷新还是报错？那就是缓存搞的鬼，很多人都漏了这一步。

3.1 没清迅睿的系统缓存

迅睿CMS会自动编译缓存模板，你改了引入代码，后台还存着旧的错误内容。

操作步骤：打开迅睿后台，点击系统工具-更新全部缓存，等十秒再刷新前台。

3.2 浏览器或者CDN缓存没清

你网站开了CDN加速的话，CDN会缓存你的静态文件，旧的错误文件还存在CDN节点上。

操作方法：先开浏览器的隐私模式打开试试，隐私模式没有本地缓存。

如果隐私模式能打开，就清一下浏览器缓存，开了CDN的再去CDN后台刷新下缓存就行。

其实说来说去，迅睿CMS的文件引入报错，真的都是小事，根本不需要大动干戈改系统。

你照着这三步顺一遍：先查路径对不对，再看权限目录放错没，最后清一遍所有缓存。

99%的问题，你自己5分钟就能解决，不用到处发帖求人。

要是你现在正好遇到这个报错，别愣着，现在就打开你的网站，对着第一步开始查，改完刷新看看，说不定直接就好了。