Asp.net Core+Angular项目安装NPM启动报freeze-ui.js不存在

集成Angular的ASP.NET Core项目完成npm install依赖安装后，执行npm start启动时抛出构建错误：

Script file src/assets/freeze-ui/freeze-ui.js does not exist

按优先级从高到低依次排查：

• 第一步：确认依赖包完整性
  打开项目根目录的package.json，检查dependencies节点下是否存在freeze-ui依赖声明。如果不存在，直接执行安装命令：
  npm install freeze-ui --save
  安装完成后进入node_modules/freeze-ui/dist目录，确认目录下存在freeze-ui.js源文件。如果该目录文件缺失，直接删除项目根目录下的node_modules文件夹和package-lock.json文件，重新执行npm install拉取完整依赖，排除缓存损坏、网络波动导致的依赖包下载不全问题。
• 第二步：修正Angular构建配置的路径错误
  这是该问题最高发的原因：打开项目根目录的angular.json文件，定位到projects -> [你的Angular项目名] -> architect -> build -> options -> scripts配置段，检查是否存在硬编码的src/assets/freeze-ui/freeze-ui.js引入规则。
  该配置的问题在于npm安装的第三方包默认存放在node_modules目录，不会自动同步到src/assets路径，可选择两种方案修复：
  1. 直接修改引入路径为依赖包的实际位置：将原路径替换为node_modules/freeze-ui/dist/freeze-ui.js，Angular构建时会自动从node_modules读取脚本完成打包，无需手动复制文件，改完保存重新执行npm start即可。
  2. 保留assets路径引用规则：手动在src/assets目录下新建freeze-ui文件夹，将node_modules/freeze-ui/dist路径下的freeze-ui.js及配套样式文件复制到新建的文件夹中，确保文件名和配置中声明的完全一致（不要把压缩版freeze-ui.min.js重命名为非压缩版使用，也不要额外嵌套子目录）。如果需要避免每次重装依赖都手动复制，可以在package.json的scripts节点下添加安装后自动复制的钩子：

     "postinstall": "xcopy node_modules\\freeze-ui\\dist\\* src\\assets\\freeze-ui\\ /s /y"
     

• 第三步：检查自动资源复制规则配置
  如果项目配置了自动将npm依赖资源复制到assets目录的构建规则（比如通过bundleconfig.json、gulp自定义任务、ASP.NET Core静态资源托管规则实现），检查复制规则的源路径是否正确。常见错误是把源路径写为node_modules/freeze-ui/*，但实际脚本文件存放在node_modules/freeze-ui/dist/*子目录下，导致复制到目标文件夹的内容为空，修正源路径即可。
• 第四步：排查路径大小写、后缀匹配问题
  如果是在WSL、Linux容器、类Unix系统下执行构建，文件路径是严格区分大小写的，检查实际文件名的大小写、后缀名（比如是否误存为.mjs后缀、首字母大写的Freeze-UI.js），和配置中的路径保持完全一致即可。

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