HTML本身是静态标记语言，无需包管理工具；npm等工具仅服务于配套的JS模块、CSS预处理器或构建流程，而非HTML标签解析。
HTML 开发环境为什么不需要安装包管理工具
HTML 本身是静态标记语言，浏览器直接解析执行，不涉及编译、依赖解析或模块加载——npm、yarn、pnpm 这些工具压根不参与 HTML 文件的运行过程。
你看到的“HTML 开发环境装包管理工具”，实际是为配套的 JavaScript（比如用 fetch 调接口）、CSS 预处理器（如 sass），或构建流程（vite、webpack）服务的，不是给 <h1></h1> 标签用的。
常见错误现象：npm install 后页面没变化、Uncaught ReferenceError: require is not defined、本地双击打开 index.html 时 JS 模块报错——这些都不是 HTML 的问题，而是误把 Node.js/模块化开发流程套在纯静态 HTML 上了。
什么时候才真得装 npm 或 pnpm
只有当你的 HTML 项目里出现了以下任一情况，才需要包管理工具：
立即学习“前端免费学习笔记（深入）”；
-
import语句（比如import { debounce } from 'lodash-es'） - 用了
vite、webpack、esbuild等构建工具启动本地服务 - 写了
.scss或.ts文件，需要编译成浏览器能跑的 CSS/JS - 用
eslint、prettier做代码检查或格式化
此时装的是开发依赖，不是“HTML 的依赖”。package.json 里 devDependencies 字段才是主角，dependencies 大概率用不上。
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
纯 HTML 项目怎么避免被带偏节奏
如果你只是写几个页面、做原型、交作业、搭静态宣传页，别碰 npm init。直接这么干：
- 新建文件夹，放
index.html、style.css、script.js - 所有 JS 逻辑写在
<script></script>标签里，或用type="module"直接导入 CDN 链接（如https://cdn.jsdelivr.net/npm/lodash-es@4.17.21/lodash.min.js） - 需要图标？用
<link rel="icon" href="favicon.ico">，别去npm install @heroicons/react - 想用现代 CSS 特性（
clamp()、aspect-ratio）？查 Can I Use，不用装任何东西
强行加 node_modules 和 package-lock.json 只会让项目变重、Git 记录变乱、协作时别人第一反应是“这 HTML 怎么还带构建？”
如果真要上构建工具，选哪个更轻量
不是所有 JS 项目都该从 create-react-app 开始。对 HTML 主导的轻量项目，优先考虑：
-
vite：开箱支持.html入口，vite build直出静态文件，不用配webpack.config.js -
esbuild：单命令打包 JS/CSS，esbuild --bundle script.js --outfile=dist/bundle.js，零配置 - 完全不用构建？就用
serve（npx serve）起个本地 HTTP 服务，解决跨域和 MIME 类型问题
注意：vite 默认开启 ES 模块支持，但如果你的 HTML 里还有 <script src="old.js"></script> 这种全局变量写法，得手动关掉 build.rollupOptions.treeshake，否则可能被剔除。
真正卡住人的从来不是“怎么装”，而是分不清“这个功能是浏览器原生支持的”，还是“这个功能必须靠构建链路注入”。HTML 开发最省心的状态，就是打开编辑器，保存，刷新，立刻看见效果——其余都是可选项，不是入场券。
