shadow-cljs compile app与release app命令的区别及部署最佳实践

核心区别 #

• shadow-cljs compile app：属于开发模式构建，侧重调试效率。会保留完整的源码映射（source maps），不做代码压缩，编译速度快，输出的代码可读性高，同时包含热重载等开发辅助逻辑。
• shadow-cljs release app：属于生产模式构建，侧重运行性能与体积优化。会执行代码压缩（minify）、死代码消除（tree-shaking），移除所有开发辅助代码，默认不生成源码映射（可配置开启），输出文件体积小、运行效率高。

各自选择的影响 #

用compile部署的影响 #

• 优势：部署后出现问题时，可通过源码映射快速定位到源码位置，调试成本低；编译速度快，适合临时测试部署场景。
• 劣势：代码体积大，页面加载速度慢；运行时存在额外性能开销；包含开发环境代码，可能暴露源码结构，存在安全隐患。

用release部署的影响 #

• 优势：文件体积小，加载与运行效率高；移除了开发无关代码，安全性更好；完全适配正式生产环境的性能要求。
• 劣势：编译耗时较长；默认无源码映射，生产环境调试需额外配置生成。

部署前最佳实践 #

• 正式生产部署必须使用shadow-cljs release app，这是shadow-cljs针对生产环境的标准构建方式，确保应用性能与安全性。
• 若需保留生产环境调试能力，可在shadow-cljs.edn的release配置中添加:source-map true生成生产版源码映射，但注意不要将其放在公开可访问路径，或对映射文件做混淆处理。
• 部署前先在本地执行release构建，测试生成的静态文件是否能正常运行，避免直接部署后出现问题。
• 无需每次编译前都执行rm -rf .shadow-cljs，仅在遇到缓存导致的异常问题时再清理，频繁清理会增加编译耗时。
• 可将构建与部署流程整合，比如在package.json中添加脚本："deploy": "shadow-cljs release app && firebase deploy"，实现一键完成构建与Firebase部署。

内容的提问来源于stack exchange，提问作者Pedro Delfino