live server 本质是启动本地 http 服务(如 http://127.0.0.1:5500),而非简单打开文件;必须先保存 html 文件,再通过 ctrl+shift+p 输入“live server: start”触发,右下角显示端口即成功。

Live Server 对 HTML 文件的预览不是“打开”,而是“启动服务”
VSCode 本身不支持直接双击预览 HTML,file:// 协议下 JS/CSS 加载会因 CORS 被浏览器拦截。Live Server 的本质是起一个本地 HTTP 服务器(如 http://127.0.0.1:5500),让资源按 Web 标准加载。
它不响应右键菜单里的“Open with Live Server”——这个选项在路径错误、未保存文件或端口冲突时容易静默失败,实际可用的是命令面板触发:
- 必须先保存文件,否则提示
Please save file before start live server - 快捷键
Ctrl+Shift+P→ 输入Live Server: Start→ 回车 - 首次运行后,右下角显示端口号;重复执行会复用同一端口,不会新开服务
- 想换快捷键?在设置里搜
keyboard shortcuts,右键该命令 →Change Keybinding
vscode-pdfviewer 预览 PDF 不依赖外部程序,但需注意默认行为
双击 PDF 文件即可在 VSCode 内打开,靠的是 pdf-preview 自定义编辑器,不是调用系统 Acrobat 或 Evince。
常见误操作是以为“开了就能缩放/翻页”,其实部分功能默认关闭:
- 同步滚动需手动开启:
markdown.preview.scrollPreviewWithEditor和markdown.preview.scrollEditorWithPreview是 Markdown 设置,PDF 预览不走这套;PDF 的滚动独立,靠工具栏按钮或鼠标滚轮 - 默认光标是
select(文本选择),若想拖拽页面,需设"pdf-preview.default.cursor": "hand" - 缩放级别默认为
"auto",若希望固定 100%,设"pdf-preview.default.scale": "1.0" - 侧边栏打开而非新标签页:右键 PDF 文件 →
Open Preview,不是Open With
vscode-office 插件能预览 Excel/Word,但格式还原有边界
它对 .xlsx、.docx 的渲染基于 Office Online 的轻量解析逻辑,不是完整 Office 引擎,所以别指望公式计算或复杂宏。
真正影响体验的几个硬限制:
- 表格跨页断行、分栏、页眉页脚等排版基本不还原,仅保证单元格内容和基础样式
- 嵌入对象(如图表、OLE 对象)会被忽略或显示占位符
- 中文宋体/微软雅黑等字体若系统未安装,会 fallback 到默认无衬线体,无法强制指定
- 右键导出 PDF 时,“带大纲”选项只对 Word 文档生效,Excel 导出 PDF 永远无大纲
Markdown 预览的“实时”是假象,本质是“保存即刷新”
Ctrl+Shift+V 打开的是静态快照,不是监听编辑器内存。改完文字不点 Ctrl+S,预览永远不变。
想减少手动保存动作,可调整两个关键配置:
-
files.autoSave设为onFocusChange(切出编辑器时自动存)或afterDelay(延迟存,需配files.autoSaveDelay) -
markdown.preview.autoRefresh必须为true(默认值),但它只对已保存文件生效 - 预览窗口右上角的
↻按钮不是“重读文件”,只是重新渲染当前 HTML,没保存照样白按 - 数学公式和 Mermaid 图表:原生预览完全不支持,
Markdown Preview Enhanced才管这事,且需单独开启enableMermaid
真正卡住多数人的从来不是插件装没装,而是没意识到:VSCode 所有预览都建立在“磁盘文件”之上,不是“编辑器缓冲区”。这点不厘清,所有“为什么没变”的问题都会反复出现。











