HTML本身不能直接发布为npm包；npm包本质是JavaScript模块，需通过构建工具打包成UMD/IIFE格式并配置package.json的main、unpkg等字段，才能在浏览器中用script标签引入。
HTML 本身不能直接“发布为 npm 包”，npm 包本质是 JavaScript 模块（或含资源的模块化产物），但你可以把面向浏览器的 HTML 工具库、组件库、工具函数集打包成 npm 包，供其他项目 import 或 require 使用——关键在于「如何让代码在浏览器和 Node 环境都可用，且支持多种引入方式」。
npm 包必须有 main 入口，但浏览器不认 require
当你写好一个工具函数（比如 htmlEscape），直接丢进 index.js 并设 "main": "index.js"，Node 里能用，但纯 HTML 页面用 <script> 引入会报 require is not defined。这不是 npm 发布失败，而是没适配浏览器运行时。
- npm publish 只负责上传文件，不解决执行环境问题
-
main字段默认服务 Node 的require()，不是浏览器的<script> - 若想浏览器直连，得额外提供 UMD 或 IIFE 格式的构建产物（如
dist/mylib.min.js），并在package.json中通过"unpkg"或"browser"字段声明
Vue 组件库发布要走 --target lib 构建
如果你的包是 Vue 单文件组件（.vue），不能直接把 src/ 下的 .vue 文件设为 main——npm 不解析 .vue，浏览器也不认识。必须用构建工具编译成 JS 模块。
- Vue CLI 项目中，改
package.json的build-bundle脚本："build-bundle": "vue-cli-service build --target lib --name mylib ./src/index.js" -
./src/index.js必须显式导出组件：export { default as MyButton } from './components/MyButton.vue' - 构建后生成的
dist/mylib.common.js才是真正的main入口；同时建议加"module": "dist/mylib.esm.js"支持 tree-shaking - 别漏掉
"types": "types/index.d.ts"（如果提供 TypeScript 类型）
npm publish 前必须检查这三件事
90% 的发布失败或安装后报错，源于这三个配置项没对齐：
立即学习“前端免费学习笔记（深入）”；
-
name：必须全局唯一，且只能用小写字母、数字、短横线（-），不能有下划线或大写；发布前去 https://www.php.cn/link/37e43572006d4d3deec54812aa12e872 搜一下是否重名 -
version：每次npm publish都必须升级版本号（哪怕只改1.0.0 → 1.0.1），否则会报403 Forbidden -
main/exports：确保该字段指向的文件真实存在、语法合法、且导出内容符合预期（比如module.exports = { htmlEscape }，不是export default写法混用）
浏览器里直接试 npm 包？用 unpkg 或 jsdelivr
发布成功后，不用 npm install 就能在 HTML 里快速验证：
<script src="https://unpkg.com/ywb-tools@1.0.1/dist/ywb-tools.umd.min.js"></script> <script> console.log(ywbTools.dateFormat(new Date())); // ✅ </script>
前提是你的 package.json 里声明了 "unpkg": "dist/ywb-tools.umd.min.js"，且构建脚本实际生成了这个文件。没声明？unpkg 会 fallback 到 main，但大概率失败——因为 main 是 CommonJS 格式，浏览器无法执行。
真正容易被忽略的是：你写的每个 require() 或 import，在浏览器里都得有对应运行时支撑；而 npm publish 只管“发文件”，不管“能不能跑”。打包目标、导出格式、入口字段、CDN 路径，四者必须咬死。
