创建首个Angular项目选择CSS样式表时提示Schematic workflow失败如何解决

常见触发原因 #

• 项目创建路径包含中文、空格、特殊字符，Schematic工具对非ASCII路径兼容性差
• npm使用官方源时网络波动，依赖包拉取中断
• npm本地缓存存在损坏残留
• 系统权限不足，无法写入文件到目标目录
• Node.js版本和当前Angular CLI版本不兼容
• 交互式创建引导的流程异常

分步解决方法 #

1. 检查项目路径
   切换到全英文、无空格、无特殊字符的目录下执行创建命令，例如Windows下的D:\dev\angular-projects、macOS/Linux下的~/dev/angular-projects

2. 切换npm国内镜像源
   临时替换为淘宝镜像源降低网络失败概率：

npm config set registry https://registry.npmmirror.com

项目创建完成后可切回官方源：

npm config set registry https://registry.npmjs.org

3. 清理npm残留缓存
   强制清理所有本地缓存：

npm cache clean --force

4. 提升执行权限

• Windows系统：右键点击CMD/PowerShell/终端，选择「以管理员身份运行」后再执行创建命令
• macOS/Linux系统：创建命令前添加sudo提升权限：

  sudo ng new 你的项目名称
  

5. 适配版本兼容性
   目前Node.js 18 LTS版本和各版本Angular CLI兼容性最好，如果你使用的是Node 19/20+的最新版本，可以卸载当前Node，安装Node.js 18 LTS版本后重试。

6. 跳过交互式引导创建
   直接通过命令参数指定项目配置，避开引导流程的异常：

# 示例：创建使用CSS样式、不启用路由的项目
ng new 你的项目名称 --style=css --routing=false

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