新建index.html文件夹并用Live Server插件启动本地服务即可，无需项目配置、build工具或launch.json等冗余文件；核心是路径正确和通过http协议访问。
新建 index.html 就够了，不需要“项目配置”
VS Code 本身不管理“HTML 项目”概念——它只打开文件夹或文件。所谓“新建 HTML 项目”，本质就是建一个文件夹，往里放 index.html，再双击/右键用浏览器打开。没有 build、没有 package.json、也不需要插件初始化。
常见错误现象：vscode 报错 “Cannot find module ‘html’” 或者点开 index.html 页面空白——其实不是 VS Code 的问题，而是没启动本地服务，或者路径写错了。
- 直接新建文件夹 → 新建文件 → 输入
index.html→ 写好基础结构（hello） - 右键
index.html→Open with Live Server（需装插件）；不装插件就右键 →Reveal in Finder/Explorer→ 双击用系统默认浏览器打开 - 不要试图在 VS Code 里运行
npm init或vue create来“配 HTML 项目”——那已经不是纯 HTML 场景了
Live Server 插件是唯一值得装的“HTML 配置”工具
纯静态 HTML 开发中，最大的痛点是改完保存要手动刷新浏览器，且 file:// 协议下 AJAX、fetch、相对路径引入 JS/CSS 可能失效。Live Server 插件起一个本地 http://127.0.0.1:5500 服务，自动刷新 + 正确解析相对路径。
使用场景：你写了个 script.js 放同目录，index.html 里写 <script src="script.js"></script>，只有通过 Live Server 才能正常加载。
立即学习“前端免费学习笔记（深入）”；
- 安装插件时认准名字：
Live Server（作者：Ritwick Dey），别装错成HTML Server或其他类似名 - 启动后注意右下角状态栏出现
Go Live按钮，点击即开服务；关闭时点它右边的Stop Live Server - 默认端口是
5500，如果被占用会自动换到5501，但不要手动改配置——除非你明确需要固定端口（改settings.json中liveServer.settings.port）
launch.json 和 tasks.json 对纯 HTML 是冗余的
有人搜“VS Code HTML 项目配置”，结果照着 Node.js 或 Python 教程去配 .vscode/launch.json，发现完全没用——因为 HTML 不需要调试器启动，也没有入口进程。
性能 / 兼容性影响：加了这些配置反而会让初学者误以为“必须有它们才能运行 HTML”，增加理解负担；而且某些旧版插件在有 launch.json 时会抢焦点、报错 Cannot resolve debug adapter。
- 删掉整个
.vscode文件夹不会影响 HTML 运行 - 如果误生成了
launch.json，直接删；不需要为 HTML 写preLaunchTask或runtimeExecutable - 真要跑自动化任务（比如压缩 HTML），那是构建阶段的事，属于
npm script或make范畴，和 VS Code 编辑器配置无关
路径写法错误是 HTML 项目“打不开”的最常见原因
不是 VS Code 配置问题，而是你在 index.html 里写的 src 或 href 路径和实际文件位置对不上。尤其当文件夹嵌套变深，或用了 Live Server 后根路径变成 /（对应文件夹根），很容易出错。
常见错误现象：Failed to load resource: net::ERR_ABORTED 404，控制台显示找不到 css/style.css 或 js/main.js。
- 用相对路径时，以
index.html所在位置为基准：同级写style.css，子目录写css/style.css，上级写../assets/logo.png - Live Server 下，
/css/style.css表示从项目根开始找（即你右键“Go Live”的那个文件夹），不是系统根目录 - 避免用绝对路径如
C:\myproject\css\style.css—— 这在别人电脑上必然失败，也违反 Web 规范
