导出目标决定配置路径:Markdown转PDF须用Markdown Preview Enhanced插件并配置YAML front matter与中文字体;终端日志通过右键Save As…导出,Output面板点击…→Copy All;Debug Console不可靠,不缓存日志。

导出目标决定配置路径
VSCode 本身不提供“一键导出报告”的通用功能,所谓“报告”必须先明确定义:是当前 Markdown 文档转 PDF?是调试过程中的 console.log 日志归档?还是终端里跑完的测试结果保存?三者来源不同、导出方式完全不同,强行套用同一套配置只会失败。
常见误操作是直接在 Debug Console 里按 Ctrl+A → Ctrl+C,以为复制了全部日志——但 Debug Console 本质是 REPL,不缓存 console.log() 输出,你真正想留下的日志其实早在 Terminal 或 Output 面板里。
Markdown 转 PDF 报告:必须用 Markdown Preview Enhanced
别装 Markdown PDF(yzane),它已在 2026 年彻底失效:中文方块、Mermaid 图空白、公式不渲染,不是你配错了,是底层依赖的 wkhtmltopdf 已被 Chromium 排版链淘汰。
- 装插件
Markdown Preview Enhanced(shd101wyy.markdown-preview-enhanced) - 用
Ctrl+K V打开它的专属预览窗(不是 VS Code 原生Ctrl+Shift+V) - 确认预览中代码块有高亮、$$公式已渲染、Mermaid 图显示为 SVG —— 否则导出必残缺
- 预览窗口右上角点击
↓图标导出,编辑器右键菜单里的 “Export to PDF” 是无效入口 - 文档顶部加 YAML front matter 指定字体 fallback:
---\npdf_options:\n format: 'A4'\n margin: {top: '20mm', right: '15mm', bottom: '20mm', left: '15mm'}\n stylesheet: ./style.css\n---
style.css 中至少声明两个中文字体:font-family: "Microsoft YaHei", "Noto Sans CJK SC", sans-serif;,只写一个极易 fallback 失败。
终端/输出日志导出:别碰 Debug Console
Debug Console 不是日志缓冲区,它不记录 console.log()、print() 或程序 stdout。你看到的输出实际分流在:
-
Terminal:运行node app.js或python test.py的结果 → 右键 →Save As…,或执行命令workbench.action.terminal.saveAs -
Output面板:TypeScript 编译、Maven 构建、Git 操作等插件日志 → 点击面板右上角…→Copy All,粘贴到文本文件即可 -
Debug Console:仅支持人工复制,且对象需先点击箭头展开才能复制完整结构;[Object]直接复制毫无意义
若真需要“一键”,可在 keybindings.json 绑定快捷键触发 workbench.action.terminal.saveAs,但该命令无参数,无法指定文件名或路径,仍需手动确认保存位置。
快捷键共享与跨平台陷阱
团队要共用“导出报告”快捷键,不能直接拷贝 keybindings.json 文件——里面含平台相关修饰符和上下文条件,硬搬过去大概率失效。
- Windows/Linux 的
ctrl+alt+e在 macOS 上得写成cmd+alt+e,VS Code 不自动转换 -
when字段如inDebugRepl或notebookEditorFocused依赖对应扩展已启用,否则按键无响应 - 推荐用
workbench.action.terminal.toggle这类平台无关命令,它们由 VS Code 内部映射 - 导入时别覆盖原文件,用图形界面
Ctrl+K Ctrl+S逐条粘贴,它会自动合并并标出冲突项
真正难的从来不是绑定快捷键,而是让所有人机器上的字体、Puppeteer Chromium、插件版本、YAML front matter 结构都对齐——这些细节不处理,点一百次“导出”也得不到可用的报告。


















