从GitHub仓库子目录安装自定义TypeScript包失败求助

问题原因拆解 #

1. 直接安装整个Monorepo导致包名不符 #

你执行npm install 'willnaoosmith/react-select'时，npm拉取的是整个react-select的Monorepo仓库，而根目录的package.json中name字段是@react-select/monorepo，不是react-select。你的项目里引用的是react-select，自然会出现模块找不到的错误。

2. Gitpkg安装子包未自动编译 #

用Gitpkg安装子包时，它仅会拉取指定目录的源码，但react-select是TypeScript开发的，必须编译生成dist文件夹才能被项目识别。Gitpkg不会自动执行编译脚本，所以你看到node_modules里没有dist目录，导致模块无法解析。

解决办法 #

方法一：给子包添加自动编译脚本 #

1. 打开你fork的仓库中packages/react-select/package.json文件，检查scripts字段是否包含prepare脚本。如果没有，添加：

"scripts": {
  // 保留原有脚本，新增以下内容
  "prepare": "npm run build"
}

prepare脚本会在npm安装Git仓库包时自动执行，而原react-select的build脚本负责生成dist文件夹。

2. 将修改提交并推送到你的fork仓库的master分支。

3. 重新执行Gitpkg安装命令：

npm install 'https://gitpkg.now.sh/willnaoosmith/react-select/packages/react-select?master'

安装完成后，检查node_modules/react-select目录，应该已经生成dist文件夹，项目就能正常解析模块了。

方法二：本地打包后安装（更稳妥） #

1. 本地克隆你的fork仓库，进入packages/react-select目录，执行编译命令：

npm run build

2. 生成本地安装包：

npm pack

执行后会得到类似react-select-x.x.x.tgz的文件。

3. 在你的项目中安装这个本地包：

npm install /path/to/react-select-x.x.x.tgz

这种方式能确保你安装的是已经编译好的完整包，不会出现缺失dist的问题。

额外检查点 #

安装完成后，确认node_modules/react-select/package.json中的main、module字段是否指向dist目录下的文件（比如main字段应为dist/index.js），如果路径错误，也会导致模块找不到。

内容的提问来源于stack exchange，提问作者William Brochensque junior