从本地文件夹安装NPM包时files配置未生效，所有文件被引入的问题排查

首先，你遇到的核心问题是**npm pack和npm install file:<path>的行为差异**——这不是你的操作错误，而是npm在处理本地目录安装时的规则和打包发布时存在区别：

• npm pack会严格遵守你package.json里的files白名单，只打包指定的文件；
• 但在npm v7及更早版本中，npm install file:<path>（也就是你用"components": "file:../../common/components"这种方式）默认会复制整个源目录的内容到目标项目的node_modules，它只会自动忽略.gitignore里的文件，并不会完全遵循files字段的过滤规则。这就是为什么你会看到src、node_modules这些额外文件被包含进来。

下面是几个可行的解决办法：

方法一：添加.npmignore文件明确排除不需要的文件 #

在你的组件库根目录创建.npmignore文件，把不需要被安装的文件/目录列进去：

src/
node_modules/
.babelrc.json
package-lock.json

这样npm在处理本地file安装时，就会自动忽略这些文件，只保留files字段指定的lib/和package.json。

注意：.npmignore的优先级高于files字段，如果某个文件同时出现在files和.npmignore里，会被排除。

方法二：先打包为tgz再安装（最可靠的方式） #

如果你想完全复用npm pack的过滤逻辑，可以先在组件库目录生成tgz包，再在应用里安装这个包：

# 1. 进入组件库目录
cd ./common/components
# 2. 生成打包文件（会得到类似 components-1.0.0.tgz 的文件）
npm pack
# 3. 回到应用目录，安装这个tgz包
npm install ../../common/components/components-1.0.0.tgz

这种方式安装的内容和你发布到npm仓库的包完全一致，只会包含files字段指定的内容。

方法三：修正main字段（规范优化，非必要但推荐） #

另外，你的package.json里的main字段写法不太规范："main": "lib/*"是无效的，main应该指向一个具体的入口文件，比如你的组件库的主入口是lib/index.js，就改成：

"main": "lib/index.js"

这不会直接解决文件被过度包含的问题，但能让你的包符合npm的规范，避免后续其他潜在问题。

内容的提问来源于stack exchange，提问作者JP Strydom