VSCode无法实现代码与PDF的双栏联动，因PDF是二进制封闭格式，插件仅渲染不解析结构；可通过手动分屏实现视觉并置：右键Open Preview后拖拽至右侧，双击标签转为常驻。
VSCode 本身不支持代码区与 PDF 预览区的“双栏对比”——PDF Viewer 插件只提供 PDF 渲染，不能像 Markdown 那样自动联动源码和输出。所谓“双栏查看”，本质是手动分屏 + 独立窗口管理，不是真正的语义级对比。
为什么不能像 Markdown 那样双屏联动
Markdown 预览能实时同步滚动、点击跳转，是因为它解析的是同一份文本源；而 PDF 是二进制封闭格式，PDF Viewer 只做渲染，不解析结构、不提取大纲、不映射行号或锚点。你打开 main.py 和 api_ref.pdf 并排，它们之间没有任何逻辑关联，VSCode 也不会为你建立跳转链接。
- PDF Viewer 不监听代码编辑器事件，无法响应光标位置变化
- 没有 API 支持从 Python 注释里自动提取
./docs/manual.pdf#page=5这类带锚点的路径并触发跳转 - 插件不提供“同步滚动”开关，也不存在
pdf.preview.syncWithEditor这类配置项
如何实现可用的“代码+PDF”双栏布局
目标是让代码在左、PDF 在右，各自独立但视觉并置。这不是插件功能，而是 VSCode 原生编辑器分组能力：
- 先打开代码文件（如
config.py），确保它在左侧标签页 - 在资源管理器中右键 PDF 文件 → 选
Open Preview（不是双击） - 把刚打开的 PDF 标签页拖到右侧空白区域，出现竖直分隔线后松手，即完成分栏
- 若 PDF 标签名显示为斜体，说明它处于预览模式 → 双击该标签，使其变为常驻状态
- 按
Ctrl+\可快速在当前编辑器组内再分一栏，但注意：PDF Viewer 不支持在同一个编辑器组内多次打开同一 PDF，会复用已有标签
常见卡点与绕过方式
实际操作中容易卡在三处：
-
Open Preview右键菜单不出现 → 检查是否安装了正确插件：PDF Viewer（发布者tomoki1207），且已全量重启 VSCode - 拖 PDF 到右侧失败，弹出新窗口而非分栏 → 关闭所有外部窗口，确保目标是当前主窗口的编辑器区域；也可用快捷键
Ctrl+K Ctrl+Right将当前 PDF 标签移到右侧组 - PDF 加载为空白或报错
Failed to load PDF file→ 路径含中文或空格是主因，把 PDF 移到工作区根目录下（如./manual.pdf），避免./docs/用户手册 v2.1.pdf
真正需要“代码跳转到 PDF 对应章节”的场景，靠 VSCode + PDF Viewer 无法实现。要么手动维护 PDF 页面编号与代码注释的对应关系，要么换工具链：用 Sphinx + LaTeX 生成带交叉引用的 PDF，或直接在 Obsidian 中用 Dataview 查询代码片段并链接到 PDF 片段（需 OCR 后结构化处理）。
