VSCode默认不支持直接打开.docx或.pdf文件，需分别安装Office Viewer和PDF Viewer（作者tomoki1207）扩展，二者不可互换；安装后须启用、重启，并确保语言包与文件编码匹配。
VSCode 打不开本地 .docx 或 .pdf 文件？先确认装对扩展
VSCode 默认不支持直接渲染 Word 或 PDF 文档，必须靠扩展补足能力。常见误区是以为“装了 Office Viewer 就能开所有格式”，其实它只处理 .docx、.xlsx 等 Office 格式；PDF 则要单独装 vscode-pdfviewer（作者 tomoki1207）。两个扩展互不替代，离线环境下尤其容易漏装其中一个。
验证方式很简单：在扩展面板搜索 office viewer，确认已安装且启用；再搜 pdfviewer，看是否出现 vscode-pdfviewer 并已启用。没装就无法双击打开对应后缀文件，也不会在右键菜单里显示“Open with PDF Preview”。
离线环境下载 .vsix 文件的可靠路径在哪
不能直接从 GitHub 仓库 clone 源码或下载 .zip，VSCode 只认官方打包的 .vsix 文件。正确做法是：
- 在有网机器上打开 VS Code → 扩展视图 → 搜索
office viewer→ 进入详情页 → 点击右下角Download Extension链接（URL 含/item?itemName=的，把item替成vsix即可得直链） - 同理，对
vscode-pdfviewer，搜索后点同位置下载按钮，得到vscode-pdfviewer-1.4.0.vsix类似文件 - 注意文件名里的版本号（如
-1.4.0），需与你本地 VS Code 版本兼容（VS Code 1.85+ 推荐用 1.4.0+）
安装后双击仍无响应？检查是否被禁用或路径错误
装完扩展不等于自动接管文件类型。常见卡点：
- 扩展虽已安装，但状态栏右下角仍显示
en或未出现文档预览图标 → 检查是否手动启用：在扩展面板找到对应条目，点击右侧启用按钮（圆点变蓝） - 拖拽
.pdf文件进编辑区没反应 → 确认不是误拖到终端或调试控制台区域；应拖到左侧资源管理器空白处，或直接双击文件树中的文件 - 右键菜单没有“Open with…”选项 → 可能是工作区设置了
"files.associations"覆盖了默认行为，临时删掉该配置再试 - 报错
INVALID_SIGNATURE→ 离线环境证书链不可达，加参数重装：code --install-extension office-viewer.vsix --allow-unverified
打开后内容乱码或空白？重点查 locale 和编码设置
特别是中文 Word 文档，离线场景下容易因语言包缺失或编码识别失败导致文字显示为方块或空格：
- 确保已按离线汉化流程装好
vscode-language-pack-zh-hans.vsix，并执行过Configure Display Language→ 选zh-cn→ 重启 -
.docx内容乱码，大概率是文档本身用了非 UTF-8 编码保存，Office Viewer 不做转码；可先用 LibreOffice 打开另存为“UTF-8 编码的 .docx”再试 - PDF 显示空白或字体缺失 → 检查是否启用了硬件加速（设置中搜
pdf-preview.hardwareAcceleration，设为on）；大型 PDF 建议关闭其他标签页释放内存
