package.json scripts 配置避坑指南：AI编程工具中 bin/files 字段的 4 种典型误用场景

1. 问题结论先行：AI编程工具生成的bin和files配置，有近70%的概率在首次npm publish时触发权限拒绝或包体积暴增——这不是 npm 的 bug，而是 AI 对 Node.js 模块发布契约的理解偏差。我最近帮三个团队做 CI/CD 流水线审计，发现一个高频但极少被文档提及的现象：用 Cursor、Claude Code 或 Trae 等主流 AI 编程工具辅助编写package.json时，只要涉及bin或files字段，几乎必然出现两类问题中的一种：- 一类是npm publish直接报错EPERM: operation not permitted, symlink，尤其在 Windows 或 Docker 构建环境中；- 另一类更隐蔽：发布的包体积比预期大 3–8 倍，node_modules/.bin/xxx被打包进 tarball，导致下游用户安装时多下载 20MB+ 无用依赖。这两个问题背后，不是 AI “写错了”，而是它默认把package.json当作纯配置文件来补全，却忽略了bin和files是 npm 发布生命周期中的契约性声明字段——它们不只影响本地开发体验，更直接决定npm publish时的文件裁剪逻辑、符号链接行为、以及npm inst