LaTeX Workshop 扩展格式化功能配置指南

问题背景

近期在LaTeX Workshop扩展的10.4.0版本更新后，部分Windows用户遇到了文档格式化功能失效的问题。当用户尝试使用"Format Document"命令时，系统会提示"Formatter not found"的错误信息。这一变化源于新版本对格式化配置方式的调整。

问题分析

在LaTeX Workshop 10.4.0版本中，开发团队对文档格式化功能进行了重构，要求用户必须显式配置格式化工具。这与之前版本中内置默认格式化器的行为不同，导致部分用户在升级后遇到格式化功能无法使用的情况。

解决方案

要解决此问题，用户需要在Visual Studio Code的设置中明确指定LaTeX文档的格式化工具。以下是具体配置步骤：

1. 打开Visual Studio Code的设置界面
2. 搜索"latex-workshop.latex.format.enabled"
3. 确保该选项已启用（设置为true）
4. 搜索"latex-workshop.latex.formatter"
5. 在下拉菜单中选择一个格式化工具，如"latexindent"

可选格式化工具

LaTeX Workshop支持多种格式化工具，用户可根据个人偏好选择：

1. latexindent（推荐）：功能强大的LaTeX专用格式化工具
2. prettier：通用的代码格式化工具，需额外配置
3. 其他自定义工具

配置示例

对于大多数用户，推荐使用以下JSON格式的配置：

{
    "latex-workshop.latex.format.enabled": true,
    "latex-workshop.latex.formatter": "latexindent"
}

注意事项

1. 确保已安装选定的格式化工具（如latexindent通常随TeX发行版一起安装）
2. 如果使用自定义工具，需要提供完整的可执行文件路径
3. 格式化规则可通过单独的配置文件进行自定义

版本兼容性说明

这一变更反映了LaTeX Workshop向更模块化、可配置化方向的演进。虽然短期内可能需要用户手动调整配置，但从长远来看，这提供了更大的灵活性和控制权，允许用户根据项目需求选择最适合的格式化工具。

对于习惯旧版本行为的用户，可以考虑暂时回退到10.3.2版本，但建议逐步适应新的配置方式以获得更好的扩展性和未来支持。