如何从本地下载文件夹安装npm包并创建软链接?
从本地文件夹安装npm包及恢复软链接同步方式
一、从本地已下载的文件夹安装npm包
根据不同使用场景,有两种实用的安装方式:
1. 直接复制安装(无实时同步)
如果只是需要把本地包内容导入到项目的node_modules,不需要后续同步修改,直接在项目根目录执行:
# 用绝对路径 npm install /Users/your-name/Documents/local-package-folder # 或相对路径 npm install ../local-package-folder
这种方式会把本地包的内容完整复制到node_modules,后续修改本地包的文件不会同步到项目中。
2. 软链接开发安装(实时同步)
如果需要在开发本地包时,修改代码能立刻同步到项目里,推荐用npm link工具,分两步操作:
- 第一步:进入本地包的根目录(包含
package.json的文件夹),执行:
这会把本地包注册到npm的全局链接仓库中。npm link - 第二步:回到你的项目根目录,执行:
这里的npm link your-package-nameyour-package-name是本地包package.json里的name字段值。执行后,项目node_modules里会生成指向本地包的软链接,修改本地包的代码会实时同步到项目中。
二、恢复npm安装本地文件夹时的软链接行为
你提到新版本npm默认复制本地文件夹到node_modules而非创建软链接,想要恢复旧行为有两种方法:
1. 单次安装手动指定参数
每次安装本地包时,加上--link参数即可创建软链接:
npm install --link /path/to/your-local-folder
2. 全局配置默认启用软链接
如果想让所有本地文件夹的安装都默认使用软链接,修改npm全局配置:
npm config set link true
之后所有npm install本地文件夹的操作都会自动创建软链接。如果后续想改回默认复制行为,执行npm config set link false即可。
内容的提问来源于stack exchange,提问作者user6791424




