重装Windows后新建Angular项目构建失败，求解决方案

针对重装Windows后旧Angular项目正常、新项目ng build报错的场景，以下是针对性的解决步骤：

一、统一依赖版本并清理缓存 #

• 执行npm cache clean --force清理npm全局缓存
• 删除新项目下的node_modules文件夹、package-lock.json文件
• 重新安装项目依赖：npm install
• 确保全局Angular CLI与项目本地版本一致：
  • 查看全局版本：ng --version
  • 查看项目本地版本：npx ng --version（项目根目录执行）
  • 版本不一致时，先卸载全局CLI：npm uninstall -g @angular/cli，再安装匹配版本：npm install -g @angular/cli@x.x.x（替换x.x.x为项目本地版本号）

二、修复CSS相关报错 #

• 将CSS文件中的//注释全部替换为标准的/* */格式（CSS标准不支持单行//注释，部分loader会触发警告/错误）
• 检查angular.json的build配置：
  在projects.[你的项目名].architect.build.options.styles中，确认样式处理配置适配当前Angular版本，例如使用SCSS时可添加：

  "styles": [
    {
      "input": "src/styles.scss",
      "options": {
        "sassOptions": {
          "quietDeps": true
        }
      }
    }
  ]
  

• 若仍有loader报错，手动指定兼容的css-loader版本，在package.json的devDependencies中添加对应版本后重新安装：

  "css-loader": "^6.8.1"
  

三、修正TypeScript编译配置 #

• 打开tsconfig.app.json，确保include数组包含environment.ts：

  "include": [
    "src/**/*.ts",
    "src/environments/environment.ts"
  ]
  

• 检查exclude数组，避免误排除src/environments目录
• 确认compilerOptions中的baseUrl和paths配置正确，例如：

  "compilerOptions": {
    "baseUrl": "./src",
    "paths": {
      "@/*": ["*"]
    }
  }
  

四、匹配Node.js版本 #

• 查看项目package.json的engines字段，确认要求的Node.js版本
• 版本不匹配时，使用nvm切换版本：
  • 安装nvm后执行nvm install x.x.x（替换为要求的版本号）
  • 切换版本：nvm use x.x.x

五、排查VS Code环境问题 #

• 关闭VS Code，删除项目根目录的.vscode文件夹后重新打开项目
• 禁用所有第三方Angular扩展，仅保留官方的Angular Language Service，排查扩展冲突

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