本文详解使用 htmltools::includehtml() 加载本地 html 文件时常见的路径与文件名问题，重点指出大小写敏感性（如 .html 与 .html 差异）及路径规范，提供可复现的解决方案与调试建议。
在 R 中通过 htmltools::includeHTML() 加载本地 HTML 文件是构建 Shiny 应用、R Markdown 报告或交互式 HTML 小部件的常用操作。但实践中，用户常遇到类似以下错误：
Error in file(con, "r") : cannot open the connection In addition: Warning message: cannot open file 'C:/Users/grouetl/Documents/ProjetsLISE/Camille/Corpusgetz.html': No such file or directory
该错误并不总意味着文件真实不存在——更可能是 R 在底层调用 file() 函数读取时因文件系统行为（尤其 Windows 下的大小写感知差异）或路径解析失败而中断。
? 根本原因：文件扩展名大小写不匹配
尽管 Windows 文件资源管理器通常忽略扩展名大小写（例如显示 Corpusgetz.html 和 Corpusgetz.HTML 为同一文件），但 R 的 file() 函数在某些环境（特别是配合特定 R 版本、RStudio 配置或网络驱动器时）会严格校验文件名字面量。若磁盘上实际文件名为 Corpusgetz.HTML，而代码中指定 "Corpusgetz.html"，R 将无法定位该文件，从而抛出“no such file”错误。
✅ 验证与修复步骤：
立即学习“前端免费学习笔记（深入）”；
确认真实文件名：在文件所在目录中，启用“显示文件扩展名”（Windows 设置 → 查看 → 勾选“文件扩展名”），检查文件是否确实为 .HTML（全大写）而非 .html；
-
修正路径字符串：
library(htmltools) # ✅ 正确：与磁盘实际扩展名完全一致 rawHTML <- includeHTML("C:/Users/grouetl/Documents/ProjetsLISE/Camille/Corpusgetz.HTML") # ❌ 错误：扩展名大小写不匹配（即使系统显示为 .html） # rawHTML <- includeHTML(".../Corpusgetz.html") -
推荐增强鲁棒性的写法（自动检测）：
file_path <- "C:/Users/grouetl/Documents/ProjetsLISE/Camille/Corpusgetz.html" # 尝试标准小写，若失败则尝试大写 if (!file.exists(file_path)) { file_path_upper <- gsub("\.html$", ".HTML", file_path, ignore.case = TRUE) if (file.exists(file_path_upper)) { file_path <- file_path_upper message("Using uppercase extension: ", file_path) } else { stop("HTML file not found with either '.html' or '.HTML' extension.") } } rawHTML <- includeHTML(file_path)
⚠️ 其他关键注意事项
- 避免反斜杠 ：Windows 路径中的 在 R 字符串中是转义字符（如 ），务必使用正斜杠 / 或双反斜杠 \；
- 工作目录非必需：includeHTML() 接受绝对路径，无需 setwd()；相对路径需相对于当前工作目录（可用 getwd() 确认）；
- 权限与特殊字符：确保路径不含中文、空格或 Unicode 特殊符号（若必须使用，请用 normalizePath() 处理）；
- Shiny 中的使用：在 ui.R 或 fluidPage() 中直接调用 includeHTML() 即可内联渲染；若用于服务器端逻辑，请注意其返回的是 html 对象（非字符），需配合 tagList() 或 div() 使用。
✅ 总结
htmltools::includeHTML() 加载失败的首要排查点不是路径格式或权限，而是文件扩展名的字面精确性。一次简单的 .html → .HTML 修改即可解决看似神秘的“文件不存在”报错。养成检查真实文件名、优先使用绝对路径、并辅以 file.exists() 验证的习惯，可大幅提升 HTML 资源集成的稳定性与可维护性。
