如何从本地目录安装npm包时，仅导入仓库发布级别的必要文件？

这个问题我之前也碰到过，确实有点坑——npm从仓库拉包时会严格遵循.npmignore或package.json里的规则，但直接本地路径安装(npm i ../my-package)时，默认会把整个目录的文件都复制过去，包括node_modules，完全无视忽略配置。下面给你几个靠谱的解决方案：

方案1：用package.json的files字段明确指定要包含的文件 #

这是最推荐的方式，因为这个字段是npm官方认可的，不管是发布到仓库还是本地安装，都会生效。你只需要在my-package的package.json里添加一个files数组，把你需要发布的文件列进去就行：

{
  "name": "my-package",
  "version": "1.0.0",
  "files": [
    "dist/",
    "package.json",
    "README.md",
    // 如果你还有其他必要文件比如类型定义，也可以加进来，比如"types/"
  ]
}

这样一来，不管是发布npm仓库，还是本地运行npm i ../my-package，npm只会复制files里指定的文件，node_modules、开发时的配置文件（比如webpack.config.js、.gitignore）都会被自动排除。

方案2：先打包成tgz再安装本地包 #

如果你不想修改package.json，或者只是临时需要模拟生产环境的安装效果，可以用npm pack命令先把my-package打包成和npm仓库一致的压缩包，再安装这个压缩包：

1. 进入my-package目录，运行：

npm pack

这会生成一个类似my-package-1.0.0.tgz的文件，这个包就是遵循.npmignore和files规则的发布版本。

2. 然后回到my-project目录，安装这个压缩包：

npm i ../my-package/my-package-1.0.0.tgz

这样安装的效果和从npm仓库拉取完全一样，不会包含my-package的node_modules。

方案3：用npm link替代本地路径安装（开发场景） #

如果是开发期间需要实时同步my-package的代码，不想每次修改都重新安装，可以用npm link：

1. 在my-package目录运行：

npm link

2. 然后在my-project目录运行：

npm link my-package

这会在my-project的node_modules里创建一个指向my-package源目录的符号链接，不会复制任何文件，自然也不会带node_modules。不过要注意，这种方式是直接引用源文件，如果你需要的是打包后的dist文件，记得在my-package里配置好开发时的打包监听脚本。

补充说明 #

为什么本地路径安装会带node_modules？因为npm对本地路径依赖的处理逻辑和仓库包不同：仓库包是从压缩包解压，而本地路径是直接复制目录内容（除非用link），默认不会触发.npmignore的过滤逻辑。而files字段是npm用来定义包内容的官方配置，不管哪种安装方式都会遵守，所以方案1是最一劳永逸的。

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