Quarto+R生成HTML报告特殊字符渲染异常求助

针对你用R+Quarto生成HTML报告时，特殊字符（ã、ç、é、º、ª等）渲染失效的问题，试试以下几个解决步骤：

1. 确认文档本身的编码设置 #

检查Quarto .qmd 文件的保存编码：

• 在RStudio中，右下角状态栏会显示当前文件编码，确保它和你指定的编码（比如ISO-8859-1或UTF-8）一致
• 如果编码不符，点击状态栏编码选项，选择"Reopen with Encoding"，用目标编码重新打开后保存

2. 修正YAML头部的字符集配置 #

Quarto的html格式下，encoding参数并非控制输出HTML字符集的正确选项，改用charset参数：

---
title: 'Nota Técnica - Índice Socioeconômico dos Estudantes'
author: 'CAEd'
format: 
  html:
    theme: style.css
    charset: 'ISO-8859-1' # 也可尝试UTF-8
editor: visual
lang: pt
execute:
  echo: false
  warning: false
---

注：lang: pt已设置葡萄牙语环境，会辅助浏览器正确识别字符渲染规则

3. 检查R数据读取与会话编码 #

如果特殊字符来自外部数据或R代码输出：

• 读取CSV等文件时明确指定编码：

  # base R 方法
  dados <- read.csv("dados_estudantes.csv", encoding = "ISO-8859-1")
  
  # readr 包方法
  library(readr)
  dados <- read_csv("dados_estudantes.csv", locale = locale(encoding = "ISO-8859-1"))
  

• 调整R会话的区域编码：

  # 查看当前编码
  Sys.getlocale()
  # 设置为葡萄牙语编码（Windows/Linux/macOS可能略有差异）
  Sys.setlocale(category = "LC_ALL", locale = "pt_BR.ISO-8859-1")
  

4. 清理缓存后重新渲染 #

删除项目目录下的_cache文件夹，避免旧缓存文件导致的编码残留问题，然后重新运行Quarto渲染命令：

quarto render seu_arquivo.qmd --to html

内容的提问来源于stack exchange，提问作者João Augusto Freire