RMarkdown导出HTML头部含数千行JS代码的消除及格式保留咨询

冗余JS的消除方法 #

默认rmarkdown::html_document格式会默认加载Bootstrap框架、jQuery、交互组件依赖（代码折叠、目录跳转、表格排序等），即使页面无内容也会打包数千行JS，可通过以下方式减少冗余：

• 改用轻量内置输出格式rmarkdown::html_vignette，该格式为R包文档设计，默认不加载多余交互依赖，生成的HTML仅含少量必要代码，体积大幅缩小。
• 手动关闭html_document的非必要特性，在Rmd文件的YAML头部添加配置：

output:
  html_document:
    theme: null
    mathjax: null
    toc: false
    code_folding: none
    code_download: false

根据实际需求保留需要的特性即可，不需要的功能对应的JS会直接跳过打包。

两台设备生成JS差异的原因 #

两台设备生成的JS内容差异大是正常情况，核心原因是依赖包版本不同：

• 功能一致性：如果两台设备的rmarkdown、knitr、htmltools等核心依赖包主版本号一致，JS仅存在压缩/非压缩的区别，功能完全一致。如果核心包版本差异较大，依赖的Bootstrap、jQuery版本不同，可能存在细微交互功能差异，但静态内容的展示效果完全一致。
• 是否为压缩版本区别：大概率是的。htmltools 1.5.0及以上版本默认开启JS/CSS压缩，低版本不会开启压缩，会导致其中一台生成的是格式化可读的JS代码，另一台生成的是混淆压缩后的JS代码，内容看起来差异极大，但功能完全相同。

移除JS同时保留格式的方案 #

不要直接手动删除HTML文件中的JS代码，部分CSS样式和JS依赖是绑定的，直接删除会导致布局错乱。正确的做法是从渲染源头控制依赖加载：

• 如果需要保留Bootstrap样式但不需要交互JS，可在YAML配置中添加参数覆盖jQuery依赖，强制打包工具不引入所有依赖jQuery的JS组件，同时保留Bootstrap CSS：

output:
  html_document:
    theme: bootstrap
    bootstrap_version: 5
    extra_dependencies: !expr list(htmltools::htmlDependency(name = "jquery", version = "99.9.9", src = c(href = ""), script = NULL))

• 如果仅需要纯静态带样式页面，不需要任何交互功能，直接使用极简配置即可，生成的HTML仅含必要CSS，几乎无冗余JS，原有格式完全保留。

内容的提问来源于stack exchange，提问作者Cissy Yang