node.js不能直接运行html文件，因其无dom和渲染引擎；必须通过浏览器打开或启动本地服务器（如live server、http-server）来访问，否则执行node index.html会因语法错误而失败。
VSCode 本身不解析 HTML，它也不“配置 Node 环境来解析 HTML”——这是个常见误解。Node.js 无法直接执行或渲染 HTML 文件（document、window 不存在），HTML 必须由浏览器解析。所谓“用 Node 解析 HTML”，实际指两类场景：一是用 Node 脚本读取/修改 HTML 字符串（如配合 cheerio 或 jsdom），二是用 Node 启动本地服务器服务 HTML（如 Live Server 或 http-server）。配置错方向，就会卡在“为什么 node index.html 报错”这类问题上。
为什么直接 node index.html 会报错
Node.js 默认只执行 JavaScript 文件（.js），遇到 .html 会尝试当作 JS 解析，立刻抛出语法错误（比如 不是合法 JS）。这不是 VSCode 的问题，而是 Node 运行时行为。
-
node index.html→ 错误：SyntaxError: Unexpected token ' - 正确做法：用浏览器打开，或用 Node 启动 HTTP 服务来提供该 HTML
- VSCode 的作用是帮你触发这些动作（通过插件或终端），不是替你“解析 HTML”
用 Live Server 启动本地服务并实时预览
这是前端开发最常用的方式：启动一个带热重载的静态文件服务器，让浏览器访问 http://localhost:5500/index.html。
- 安装扩展：
Live Server（作者 Ritwick Dey） - 打开任意
.html文件，右键 →Open with Live Server - 默认端口
5500，可改：设置里搜liveServer.settings.port，填数字（如3000） - 注意：它不依赖 Node.js 运行时逻辑，但底层用了 Node 的
http模块 —— 所以必须已装 Node，且 VSCode 能调用node命令
用 Node 脚本读取/解析 HTML 字符串（如爬虫、模板处理）
如果你真需要“用 Node 解析 HTML”，意思是像浏览器一样操作 DOM 节点，得靠第三方库，比如 cheerio（轻量、服务端友好）或 jsdom（更接近浏览器环境，但重）。
- 初始化项目：
npm init -y && npm install cheerio - 写脚本
parse.js：
const fs = require('fs');
const cheerio = require('cheerio');
const html = fs.readFileSync('index.html', 'utf8');
const $ = cheerio.load(html);
console.log($('title').text()); // 输出 title 文本
- 运行：
node parse.js—— 这才属于“Node 解析 HTML”的正经用法 - 别漏
require和install，否则ReferenceError: cheerio is not defined -
jsdom需额外处理全局对象（window、document），对简单提取不推荐
调试 Node 服务时 HTML 不加载或路径 404
当你用 http.createServer 或 express 提供 HTML，但浏览器打不开或提示 “Cannot GET /”，多半是路径没处理好。
- 确保
res.writeHead(200, {'Content-Type': 'text/html'})，不是text/plain - 读文件要用
fs.readFileSync('index.html')，路径相对于当前工作目录（process.cwd()），不是相对于脚本位置 - 推荐用
path.join(__dirname, 'index.html')避免路径错乱 - VSCode 调试时，
cwd默认是 workspace 根目录，可在launch.json中显式设"cwd": "${workspaceFolder}"
真正容易被忽略的点：VSCode 是否能调用 node，决定了所有基于 Node 的操作能否跑起来。哪怕 Live Server 插件，底层也依赖 node 可执行。如果终端里 node -v 正常，但 VSCode 集成终端报 command not found，说明 VSCode 没继承 shell 的 PATH —— 这时候配再多插件都没用，得先修环境变量。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
