中文（简体）

1. ESC_LINK_OPEN IzE ESC_LINK_CLOSE ESC_LINK_SPLIT一般用途
2. ESC_LINK_OPEN 自定义您的设置ESC_LINK_SPLIT IzI ESC_LINK_CLOSE
3. Markdown
   1. 子项目
4. ESC_LINK_OPEN 打印ESC_LINK_SPLIT IzQ ESC_LINK_CLOSE 渲染的其他格式
5. ESC_LINK_OPEN IzU ESC_LINK_CLOSE ESC_LINK_SPLIT故障排除

<名称=“1”>

一般用途

有几种方法可以打印。

• 您可以通过图标或上下文菜单打印活动文档。
• 您可以通过图标或上下文菜单打印活动文档中的选择。
• 您可以直接从文件资源管理器面板、文件夹、文件或多选文件上的上下文菜单打印一个或多个文件。
• 可以使用文件路径对文件进行标题。标题不会出现在文档中，但某些浏览器可能会在标题中使用。
  • 您可以从以下格式中进行选择。
    • 没有路径
    • 缩写（如 D：\...\containing-folder\file.ext）
    • 工作区相对
• 文件的文件路径可以显示为文档开头的标题。
  • 设置确定是使用相对路径还是绝对文件路径。
  • 非工作区文件始终使用 absolute。
  • 当绝对路径位于用户的主目录中时，它们将转换为波浪号路径。
• 设置确定文件路径标题是否显示在单独打印的文件的开头。
• 排除列表适用于文件夹和文件选择。这样做的目的是忽略不可打印的二进制文件。

Markdown 文档可以呈现和设置样式。Markdown 部分对此进行了详细说明。

打印活动文档

要打印活动文档，只需单击文档选项卡右侧的打印机图标即可。确保您没有选择多行文本。否则，您将打印所选内容，而不是整个文档。ESC_STRONG_OPEN 在打印对话框中控制纸张大小、页边距和页面方向。ESC_STRONG_CLOSE

在活动文档中打印所选内容

在活动文档中选择多行文本块。然后单击文档选项卡右侧的打印机图标，或右键单击所选内容ESC_CODESPAN_OPEN然后从上下文菜单中选择“打印ESC_CODESPAN_CLOSE”。当上下文菜单出现时，ESC_CODESPAN_OPEN打印ESC_CODESPAN_CLOSE显示在顶部、底部或附近，具体取决于“打印：编辑器上下文菜单项位置”ESC_CODESPAN_CLOSE ESC_CODESPAN_OPEN设置。

打印输出中的行号与编辑器中的行号对齐，无论这些行号是否可见。因此，如果您在代码审查中讨论一行编号为 1145 的代码，并且打开文件进行修改，则键入 Ctrl+G，然后键入 1145 [Enter] 会将光标直接放在相关代码行上。

打印文件而不打开文件

若要打印活动文档以外的文件，请在“资源管理器”窗格中找到它并右键单击它。在文件上下文菜单中ESC_CODESPAN_OPEN“打印”ESC_CODESPAN_CLOSE始终出现在菜单顶部或附近。这将打印整个文件。

打印文件夹中的所有文件

如果按F1并键入ESC_CODESPAN_OPEN打印文件夹ESC_CODESPAN_CLOSE您会发现可以打印包含活动文档的文件夹中的所有可打印文件。将创建一个打印作业，其中所有文件都由显示其名称的标题分隔。

<名称=“2”>

自定义您的设置

这些设置中的大多数都自定义用户体验（图标、菜单位置等）。若要查找这些设置，请打开 VS Code 的设置窗格，然后导航到“扩展/打印”或仅搜索“打印”。

以下是配置文件中显示的可用设置名称列表。

• print.alternateBrowser：启用/禁用备用浏览器
• print.browserPath ：Web 浏览器的路径
• print.colourScheme ：用于着色语法的样式表
• print.editorContextMenuItemPosition ：Print在编辑器上下文菜单中的位置
• print.editorTitleMenuButton：在编辑器标题菜单中显示打印按钮
• print.fontSize ：字体大小（6 到 13 磅的选项）
• print.formatMarkdown：打印时将 Markdown 渲染为样式 HTML
• print.lineNumbers：on、off 或 inherit（来自编辑器）
• print.lineSpacing：单行距、行半行距或双倍行距
• print.printAndClose ：打印后，关闭浏览器
• print.folder.include：要包含的文件的模式。空匹配一切。
• print.folder.exclude：要排除的模式
• print.folder.maxFiles：打印文件夹时呈现其内容的最大文件数
• print.folder.maxLines：包含超过此阈值的行数的文件将被忽略
• print.logLevel：控制进入日志文件的详细程度
• print.filepathAsDocumentHeading：控制文件路径用作文档开头的标题
• print.filepathAsDocumentTitle：控制文件路径作为文档标题的使用（某些浏览器在页眉中使用）
• print.filepathHeadingForIndividuallyPrintedDocuments：控制文件路径标题是否显示在单独打印的文档的开头

自定义用户界面

您可以控制在聚焦编辑器窗格时打印图标是否显示在工具栏中。此设置标记为ESC_CODESPAN_OPEN“编辑器标题菜单按钮”ESC_CODESPAN_CLOSE。

您可以使用“ESC_CODESPAN_OPEN编辑器上下文菜单项位置”ESC_CODESPAN_CLOSE设置来控制“打印”菜单项是显示在上下文菜单的顶部、底部还是无处显示。

选中“ESC_CODESPAN_OPEN打印并关闭ESC_CODESPAN_CLOSE”设置后，打印内容将自动打开浏览器的“打印”对话框，然后在打印或取消后自动关闭浏览器。关闭此功能将打开浏览器，呈现的文档已准备好进行检查。如果随后手动打开“打印”对话框，则打印或取消它不会关闭浏览器。

使用特定浏览器打印

ESC_STRONG_OPEN 在此版本发布时，命令路由问题导致从远程工作区打印回退到使用默认打印机。全面服务将尽快恢复。ESC_STRONG_CLOSE

默认情况下，打印将使用默认浏览器。但是，打印效果最好，适用于 Chromium 衍生浏览器，并且可能无法或不希望更改默认浏览器。

若要允许您使用非默认浏览器的浏览器进行打印，您可以指定备用浏览器的路径，并且还有一个复选框允许您在不丢失路径的情况下打开和关闭此选项。

这些设置分别ESC_CODESPAN_OPEN标记为“浏览器路径ESC_CODESPAN_CLOSE ESC_CODESPAN_OPEN备用浏览器ESC_CODESPAN_CLOSE”。

备用浏览器的路径在 Windows 上是自动引用的，而在基于 Unix 的平台上，空格是转义的。不幸的是，这与提供命令行选项不兼容。

如果需要提供命令行选项，请创建指定选项的批处理文件（或 bash 脚本文件），并参考备用浏览器路径中的 bash 脚本文件。

打印源代码

使用“ESC_CODESPAN_OPEN配色方案”ESC_CODESPAN_CLOSE设置，可以指定用于语法着色的配色方案。选择仅限于浅色主题，因为打印机使用白纸。

如果打印活动文档并且存在多行选定内容，则仅打印所选内容。

类型、面和尺寸

字体由 VS Code 编辑器设置确定。如果您在屏幕上看到 Fira 代码，那就是将要打印的内容。

打印文本的ESC_EM_OPEN大小ESC_EM_CLOSE是“打印”设置，因为在屏幕上效果最佳的大小可能不是在纸张上效果最好的大小。

如果您想知道为什么我们称它为字体而不是字体，那是因为字体是具有特定大小和处理的特定字体。“12pt Times italic” 是一种字体。“Times”是一种字体。Windows 字体选择器（ESC_EM_OPEN ESC_EM_CLOSE选择字体，您必须指定字体、大小和处理方式）将字体错误地标记为“字体”，这无济于事。

打印降价

您可能希望呈现 Markdown 打印作业并设置其样式，这是默认行为。如果要将 Markdown 打印为源代码，可以取消选中 Print： Render Markdown ESC_CODESPAN_CLOSE ESC_CODESPAN_OPEN设置。

配色方案

对于源代码打印，样式表是捆绑在一起的，可以从列表中按名称进行选择。选择仅限于浅色样式表，因为打印纸是白色的，而打印机墨水和碳粉是为白纸设计的。

<名称=“3”>

降价

设置 Markdown 的样式

将 CSS 文件应用于 Markdown 文档

• 您可以将样式表链接标签直接嵌入到 Markdown 中。这是特定于文档的。
• 有一个名为 markdown.styles的设置。这是 URL 列表。内置的 Markdown 预览版和打印版都将遵循此列表。您可以使用绝对 URL、工作区相对 URL 或文档相对 URL，如以下示例所示。

"markdown.styles": [
    "https://cdn.jsdelivr.net/npm/[email protected]/dist/katex.min.css",
    "path/to/document/relative/custom.css",
    "workspace.resource/path/to/stylesheet.css"
]

工作区相对 URL 是在文档之间共享资源的最佳方式。它们位于工作区中，因此可以与文档一起进行源代码管理，并且由于 URL 相对于工作区而不是文档，因此您可以在不破坏 URL 的情况下组织（和重新组织）文件夹中的文档。请注意，这不仅适用于样式表，也适用于图像文件资源。

将样式与 Markdown 关联

从 Markdown 到生成的 HTML 的映射是显而易见的。表成为表ESC_CODESPAN_CLOSE ESC_CODESPAN_OPEN，ESC_CODESPAN_CLOSE，ESC_CODESPAN_OPEN td元素。标题H1 到 H9 ESC_CODESPAN_CLOSE ESC_CODESPAN_OPEN。段落是 P ESC_CODESPAN_CLOSE 元素ESC_CODESPAN_OPEN，项目符号和数字是 ul ESC_CODESPAN_CLOSE ESC_CODESPAN_OPEN，ol元素。

别忘了，你可以在 Markdown 中嵌入 HTML，所以没有什么能阻止你使用 div 或 span 将 CSS 类应用于 Markdown 的块或运行。

网页服务器

嵌入式 Web 服务器仅绑定到环回地址，并且仅接受指定的连接。

Katex Markdown 扩展

Katex 依赖于 CSS 和来自 Web 的字体。要使打印工作正常工作，您必须将所需的样式表添加到设置中。如果您发现一两个内容在预览中有效但未打印，请从 KaTeX 网站确定当前版本，并更新 URL。

"markdown.styles": [
    "https://cdn.jsdelivr.net/npm/[email protected]/dist/katex.min.css"
]

如果要切断电源线，请按照上一节所述将 Katex 资源导入到项目中，并使用工作区相对引用。

下面是一些示例，可帮助您检查配置。``` $$ \begin{alignedat}{2} 10&x+ &3&y = 2 \ 3&x+&13&y = 4 \end{alignedat} $$ and thus

$$ x = \begin{cases} a &\text{if } b \\ c &\text{if } d \end{cases} $$

## 呈现的 Markdown 和远程工作区

若要使用远程工作区，必须在远程主机上运行 Markdown 扩展，因为这是 Markdown 呈现管道的运行位置。只需单击一下，即可将专为远程工作区而设计的“打印”等扩展部署到远程主机。大多数 Markdown 扩展都能够像这样工作，但它们没有为此设置。

不幸的是，Markdown 扩展通常不配置为远程使用;设计人员希望它们在本地运行。

### Markdown 扩展的 DIY 补丁

如果您的需求紧急，您可以自己修补扩展。

1. 在 `~/.vscode/extensions` 中找到工作站上安装它们的扩展（在 Windows 上，用 ESC_CODESPAN_OPEN%userprofile% ESC_CODESPAN_CLOSE 替换 `~`）
2. 编辑要在远程主机上使用的 Markdown 扩展的`package.json`文件。将 `extensionKind` 添加为根级属性。
3. 编辑完所有 Markdown 扩展后，重启 VS Code。
4. 在远程主机上安装扩展，并以相同的方式在远程主机上修补扩展。


```json
...
"extensionKind": [
  "workspace"
],
...

像这样的补丁将在扩展的下一次更新中丢失，因此，如果您的补丁成功，您可能需要向发布者提交 PR。

<名称=“4”>

打印渲染的其他格式

已记录请求打印 Markdown 以外的格式的问题。示例包括 ABC 音乐标记中的乐谱和 Jupyter Notebooks。为了支持这一点，同时又不承担跟上 VS Code 中使用的每种基于文本的文档格式的难以管理的负担，我们公开了一个 API 并发布了一个 SDK，允许维护者将打印合并到他们的预览功能中。

因此，如果要为已有提供预览的扩展的特定格式进行渲染打印，请向该扩展的发布者提出问题。解释您希望打印并参考它们进行打印并参考它们

<名称=“5”>

故障 排除

先决条件

• 首先确保您可以从浏览器打印网页。
• 运行 VS Code 的用户必须能够建立侦听套接字。

首次发射麻烦

• 似乎什么也没发生 - 重启 VS Code。
• 浏览器启动但未加载页面 - 检查网络权限。
• 浏览器显示一条错误消息，提示您未找到 CSS 文件 - 您从未准备好的 VSIX 安装。获取ESC_LINK_OPEN官方软件包 ESC_LINK_SPLIT aHR0cHM6Ly9tYXJrZXRwbGFjZS52aXN1YWxzdHVkaW8uY29tL2l0ZW1zP2l0ZW1OYW1lPXBkY29uc2VjLnZzY29kZS1wcmludA ESC_LINK_CLOSE并重试。

如果有其他问题，或者你有改进的想法，我们邀请你在 GitHub 存储库上记录问题。

浏览器的选择

使用的浏览器会影响您的体验。

推荐打印

为获得最佳打印效果，请安装基于 Chromium 的浏览器或 Firefox。如果您不想将其设为默认浏览器，请利用备用浏览器设置。ESC_STRONG_OPEN 在此版本发布时，命令路由问题导致从远程工作区打印回退到使用默认打印机。全面服务将尽快恢复。ESC_STRONG_CLOSE

众所周知，以下方法效果很好。- 勇敢

• 铬
• 铬
• 边缘
• 火狐浏览器

不建议打印

• 不再支持 Edge Classic。
• 不支持 Internet Explorer。

Markdown 扩展和远程处理

若要将“打印”与远程主机一起使用，必须将其ESC_STRONG_OPEN安装在远程主机ESC_STRONG_CLOSE上。

若要在从远程主机打印文档时获得 Markdown 扩展的好处，必须使用工作区ESC_CODESPAN_CLOSE ESC_EM_OPEN的 extensionKind生成 Markdown 扩展ESC_CODESPAN_OPEN并且必须ESC_EM_CLOSE将其安装到远程主机。

大多数此类扩展不是为ESC_CODESPAN_OPEN工作区ESC_CODESPAN_CLOSE构建的。它们可以通过修改其package.json来轻松修复。不幸的是，每当扩展程序更新时，此手动补丁都可能丢失，因此您应该向修补扩展程序的作者提出问题。

备用浏览器

ESC_STRONG_OPEN 在此版本发布时，命令路由问题导致从远程工作区打印回退到使用默认打印机。全面服务将尽快恢复。ESC_STRONG_CLOSE

不能在备用浏览器路径上提供命令行选项。在 Windows 上，我们会自动在路径周围加上引号，以防文件或文件夹名称中有空格。在其他平台上，空格会自动转义。

自动引用和空格转义都与命令行选项的使用不兼容。解决方案是创建一个批处理文件（或 shell 脚本），该文件使用命令行选项启动浏览器，并提供批处理文件（或 shell 脚本）的路径。

Chrome 和插件

Chrome 可能会在打印作业之间保留您的打印机、纸张尺寸和页边距选择。某些 Chrome 命令行选项会导致系统报告错误，即使打印成功也是如此。

某些 Chrome 插件会干扰打印作业样式。虽然可以使用 --disable-plugins抑制插件，但当已经有一个正在运行的 Chrome 实例时，这不起作用。--incognito 开关在有正在运行的实例时抑制插件，但也有其自身的问题。

报告问题

如果您仍然ESC_EM_OPEN ESC_EM_CLOSE无法让 Print 工作，ESC_LINK_OPEN在存储库ESC_LINK_SPLIT aHR0cHM6Ly9naXRodWIuY29tL1BEQ29uU2VjL3ZzYy1wcmludC9pc3N1ZXM ESC_LINK_CLOSE提出问题。我们将尽力为您提供帮助。

我们可能会要求您提高日志记录级别，重现问题，然后将日志发送给我们。

伐木

使用“ESC_CODESPAN_OPEN打印：日志级别ESC_CODESPAN_CLOSE”设置设置日志记录级别。这默认为ESC_CODESPAN_OPEN错误ESC_CODESPAN_CLOSE（最小日志记录），但您可以将其一直调到ESC_CODESPAN_OPEN调试ESC_CODESPAN_CLOSE，这是非常详细的，甚至是ESC_CODESPAN_OPEN愚蠢的ESC_CODESPAN_CLOSE，甚至可以记录对垃圾回收器的调用。