问题：如何解决VSCode中Markdown导出PDF中文乱码问题？

Question

在使用 VSCode 编写 Markdown 文档并导出为 PDF 时，中文出现乱码是一个常见问题。该问题通常由默认字体不支持中文或导出配置未正确设置引起。解决方法主要包括：安装支持中文的字体（如微软雅黑、思源黑体），并在 Markdown 导出设置中指定该字体；或使用扩展如 “Markdown PDF” 并配置其样式文件以支持中文渲染。此外，确保系统环境变量和 VSCode 的编码设置为 UTF-8 也是关键步骤。通过这些调整，可有效解决 VSCode 中 Markdown 导出 PDF 时的中文乱码问题。

Answer 1

1. 问题背景

在使用 VSCode 编写 Markdown 文档并导出为 PDF 时，中文乱码是一个较为常见的问题。通常表现为导出后的 PDF 中，中文字符显示为方框或乱码符号。

这个问题的根本原因主要集中在两个方面：

• 默认字体不支持中文字符集
• Markdown 导出插件或配置未正确设置中文渲染方式

2. 问题分析

为了深入理解中文乱码的原因，我们可以从以下几个角度进行分析：

1. 字体支持问题：PDF 渲染引擎（如 Puppeteer 或 WeasyPrint）默认使用的字体可能不包含中文字符，导致无法正确显示。
2. 编码设置问题：虽然 VSCode 默认使用 UTF-8 编码，但某些插件在导出 PDF 时可能未正确识别或处理 UTF-8 字符。
3. 插件配置问题：如 Markdown PDF 插件未指定中文字体路径或样式文件。

3. 解决方案一：安装中文字体

安装并配置支持中文的字体是解决乱码问题的基础步骤。以下是推荐字体列表：

字体名称	适用系统	特点
微软雅黑	Windows	清晰、现代感强，适合屏幕与打印输出
思源黑体	跨平台	开源字体，支持多种语言，包含完整中文字符集
文泉驿正黑	Linux	开源中文字体，适合 PDF 输出

4. 解决方案二：配置 Markdown PDF 插件

使用 Markdown PDF 插件时，需手动配置其样式文件以支持中文。步骤如下：

1. 安装插件：Markdown PDF
2. 在项目根目录创建 markdown-pdf.css 文件，内容如下：

body {
  font-family: '微软雅黑', 'SimHei', 'FangSong', sans-serif;
}

1. 在 VSCode 设置中启用该样式文件：

{
  "markdown-pdf.style": "${workspaceFolder}/markdown-pdf.css"
}

5. 解决方案三：检查编码设置

确保 VSCode 和系统环境使用 UTF-8 编码：

1. VSCode 设置中添加：

{
  "files.encoding": "utf8"
}

1. 系统环境变量中设置：

export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8

6. 流程图：总结处理流程

graph TD
    A[开始] --> B[检查字体支持]
    B --> C{是否支持中文?}
    C -->|是| D[配置 Markdown PDF 插件]
    C -->|否| E[安装中文字体]
    D --> F[设置样式文件]
    F --> G[检查编码设置]
    G --> H[导出 PDF 验证]
    H --> I[完成]