VSCode默认不支持R语言格式化，需安装REditorSupport.r插件、设"[r]": {"editor.defaultFormatter": "REditorSupport.r"}、确保状态栏语言为R且editor.formatOnSave为true，否则Shift+Alt+F报错或静默失败。
VSCode 默认不支持 R 语言格式化，必须手动配置语言专属格式化器，否则 Shift+Alt+F 会报错 “No formatter installed for 'r'” 或直接静默失败。
为什么 R 文件按 Ctrl+S 不自动格式化？
根本原因不是插件没装，而是 VS Code 不知道“该调谁来格式化 R”。它不会自动把 .R 文件交给 R 专用工具——哪怕你已装好 R 插件。
-
editor.formatOnSave必须为true（全局或工作区） - 必须显式声明
"[r]": { "editor.defaultFormatter": "REditorSupport.r" }—— 注意是[r]，不是[R]或[Rscript] - 右下角状态栏语言模式必须显示为
R（不是Plain Text或Markdown），否则配置不生效 - 别在全局
settings.json里写"editor.defaultFormatter": "REditorSupport.r"，这会让 Python/JS 文件也尝试用 R 格式化器，触发报错
必须安装的插件：REditorSupport.r
这是目前唯一被 VS Code 官方认可、能稳定格式化 R 的扩展。其他如 vscode-r-lsp 或旧版 R Tools 已弃用或不提供格式化能力。
- 打开扩展面板：
Ctrl+Shift+X - 搜索
REditorSupport.r（作者：REditorSupport） - 安装后**重启 VS Code**（关键！不重启插件注册不进格式化服务）
- 验证方式：新建
test.R，输入a，选中后按 <code>Shift+Alt+F，应自动变成换行+空格对齐
R 格式化行为由什么控制？
和 Prettier 不同，REditorSupport.r 不读取 .prettierrc 或 .editorconfig，它的规则硬编码在插件内，但可通过 VS Code 设置微调：
-
"r.formatting.style": "tidyverse"（默认）→ 使用styler风格，兼容%>%管道符缩进 -
"r.formatting.style": "google"→ 更紧凑，函数参数不强制换行 -
"r.formatting.indent": 2→ 控制缩进空格数（仅影响{}和if/for块，不影响语句内空格） - 不支持自定义换行阈值（比如
printWidth），长表达式是否折行由插件内部逻辑决定
常见失败现象与绕过方法
如果格式化后代码没变化、或报错 Cannot format because the document is not saved，先检查这些点：
- 文件未保存为
.R或.Rmd后缀（.r小写后缀不识别） - 文件开头有 UTF-8 BOM 或非 ASCII 字符（如中文注释含全角空格），会导致 styler 解析失败
- 正在编辑的是
.Rmd中的代码块，需确保光标在代码块内且语言标记为{r}，否则 VS Code 会当作 Markdown 处理 - 临时解决：命令面板（
Ctrl+Shift+P）输入Format Document，手动选REditorSupport.r—— 这能确认插件本身可用，只是自动绑定失败
R 的格式化链路比 JS/Python 更脆弱，核心在于它依赖外部 R 运行时加载 styler 包；如果本地没装 styler（install.packages("styler")），插件会退回到极简缩进，不报错也不提示。
