准备发布 npm 包时,可以先看一次打包清单,避免把测试目录或本地配置一起带进去。
环境:Node.js 18+、npm 9+,在包项目根目录执行:
npm pack --dry-run
它会列出将要进入 tarball 的文件,并显示包名、版本和体积;不会生成压缩包,也不会发布到 registry。想进一步确认实际内容时,再用 npm pack 生成本地包检查。
如果清单里出现不该发布的文件,可以检查 files 字段、.npmignore 和 package.json 里的入口配置。这个动作放在 npm publish 前挺划算,尤其是仓库里同时放源码、测试和构建产物时。