如何在CKEditor中配置本地MathJax库路径以实现离线运行？

早上好！我帮你梳理几个排查和解决这个问题的关键点，应该能帮你搞定离线运行的问题：

• 验证路径的正确性
  不管用绝对路径还是相对路径，先直接在浏览器地址栏输入你配置的路径（比如../MathJax/MathJax.js），看能不能正常打开这个JS文件。如果打不开，说明路径写错了：

  • 绝对路径要对应本地服务器的Web根路径，比如你的本地服务根目录是var/www/html/infoFacile/，那正确的绝对路径应该是/js/MathJax/MathJax.js（注意开头的斜杠），而不是直接写文件系统路径var/www/html/infoFacile/js/MathJax/MathJax.js。
  • 相对路径要以CKEditor所在页面的位置为基准，比如页面在infoFacile/index.html，MathJax在infoFacile/js/MathJax/，那相对路径就是js/MathJax/MathJax.js。

• 不要遗漏MathJax的配置参数
  在线配置里的?config=TeX-AMS_HTML是核心参数，离线时必须保留！MathJax需要这个参数加载对应的渲染规则，所以你的离线配置应该写成：

  config.mathJaxLib = '../MathJax/MathJax.js?config=TeX-AMS_HTML';
  

  同时要确认你下载的MathJax包里存在config/TeX-AMS_HTML.js文件，如果没有，说明下载的包不完整，需要重新下载对应版本的完整包。

• 避免用file://协议直接打开本地文件
  如果你直接双击HTML文件用浏览器打开（路径是file:///...），会触发浏览器的安全限制，导致MathJax无法加载依赖资源。建议搭建简单的本地服务器：

  • 用Python：在项目根目录运行python -m http.server，然后通过http://localhost:8000访问应用。
  • 用XAMPP/WAMP：把项目放到服务器根目录（比如XAMPP的htdocs文件夹），通过http://localhost/infoFacile访问。
    用HTTP协议访问后，路径解析会更稳定，能避开很多本地文件访问的问题。

• 确保MathJax版本与在线一致
  你在线用的是MathJax 2.7.4，离线下载的包也必须是同一个版本！不同版本的API和文件结构存在差异，会导致CKEditor的数学插件无法兼容，去官方归档页面下载对应版本即可。

• 查看浏览器控制台的错误信息
  按F12打开开发者工具，切换到Console标签页，看看有没有404（文件找不到）或脚本错误。如果是404，直接根据错误里的路径修正配置；如果是脚本错误，大概率是MathJax加载不完整或版本不兼容的问题。

按照这几个步骤排查，应该能快速定位并解决问题！

内容的提问来源于stack exchange，提问作者Mathurin Abossolo Evina