Laravel生产环境中Markdown语法高亮失效问题求助

以下是针对该问题的常见原因及对应解决方法：

• 前端高亮依赖未正确部署
  多数Markdown语法高亮依赖前端库（如Prism.js、Highlight.js），本地开发时可能已引入，但生产环境可能存在资源未编译打包、CDN链接无法访问的情况。
  解决：

  • 若使用构建工具（如Vite），确认vite.config.js包含高亮库依赖，执行npm run build后将生成的资源部署到服务器；
  • 若使用CDN引入，检查生产环境网络是否能正常访问该CDN地址。

• Markdown渲染包的高亮配置未在生产环境启用
  部分Laravel Markdown包（如spatie/laravel-markdown）需单独开启语法高亮配置，本地配置生效但生产环境未同步。
  解决：

  • 检查config/markdown.php中highlight_code选项是否设为true；
  • 确认.env中相关配置（如MARKDOWN_HIGHLIGHT=true）在生产环境正确设置，执行php artisan config:clear清除配置缓存。

• 生产环境缓存导致旧配置生效
  Laravel生产环境默认开启配置、视图缓存，若修改高亮配置后未重新缓存，旧配置会持续生效。
  解决：执行以下命令清除并重建缓存：

  php artisan config:clear
  php artisan view:clear
  php artisan cache:clear
  

• 代码块Markdown格式不符合生产环境严格要求
  本地渲染可能对格式要求宽松，但生产环境渲染包可能启用严格模式，代码块未指定语言、缩进/分隔符不规范都会导致高亮失效。
  解决：确保代码块使用三个反引号包裹并指定语言（如php ... ），缩进式代码块需保证至少4个空格缩进。

• 服务器权限问题导致高亮样式无法加载
  若高亮CSS文件存储在本地，服务器可能无读取权限，导致样式无法应用。
  解决：调整前端资源目录权限，执行chmod -R 755 public/确保服务器用户（如www-data）可读取相关文件。

内容的提问来源于stack exchange，提问作者Usama Ramzan