Ubuntu 22下npm Workspace安装失败，Windows/Mac可正常运行

问题场景 #

使用npm workspaces管理项目，@applications/archivist依赖内部包@packages/duct。执行命令：

npm install --workspace=@applications/archivist --include-workspace-root --verbose

Mac和Windows系统下可正常完成所有嵌套包安装并按正确顺序执行postinstall脚本（先依赖包、后应用包），但Ubuntu 22系统中报错：应用的postinstall先于@packages/duct的postinstall执行，编译时出现TS2307错误，提示找不到@packages/duct模块或其类型声明。

解决方案 #

1. 统一npm版本 #

Ubuntu 22默认预装的npm版本可能与Mac/Windows存在差异（比如Ubuntu默认是8.x系列，而新系统可能用9.x），不同版本的npm workspaces对脚本执行顺序的处理逻辑有区别。

• 使用nvm安装与其他系统一致的npm版本：

  # 安装对应node版本（比如npm 9.x对应node 18+）
  nvm install 18
  nvm use 18
  

  重新执行install命令验证。

2. 确保依赖用workspace协议声明 #

检查@applications/archivist/package.json中对@packages/duct的依赖是否使用workspace协议，这会让npm明确优先处理内部依赖：

{
  "dependencies": {
    "@packages/duct": "workspace:*"
  }
}

替换掉普通的版本号声明，避免npm将其当作外部依赖处理。

3. 调整应用postinstall的执行时机 #

如果应用的postinstall依赖@packages/duct的编译产物，可以在脚本中增加等待逻辑，确保依赖包的产物生成后再执行编译：

# @applications/archivist的postinstall脚本示例
until [ -d "../packages/duct/dist" ]; do
  sleep 1
done
tsc

根据实际的产物路径调整检查逻辑，兼容不同系统的执行顺序差异。

4. 拆分命令强制指定安装顺序 #

直接拆分install命令，先完成依赖包的安装与postinstall，再处理应用：

# 先安装依赖包
npm install --workspace=@packages/duct --include-workspace-root --verbose
# 再安装应用
npm install --workspace=@applications/archivist --include-workspace-root --verbose

这种方式从根源上保证依赖包的前置处理完成。

5. 检查npm配置项 #

Ubuntu下可能存在特殊的npm配置影响workspace行为，检查install-links配置：

npm config get install-links

如果返回false，执行以下命令开启软链接支持：

npm config set install-links true

该配置确保npm正确处理workspace内部的依赖链接，让应用能访问到依赖包的编译产物。

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