启动首个Angular应用执行ng server -o命令时遭遇报错求助

兄弟，刚上手Angular就碰到启动问题太正常了！我帮你梳理几个最常见的排查方向，大概率能搞定你的问题：

• 先确认Node.js和npm版本是否兼容
  Angular对Node和npm的版本有严格要求，不同Angular版本对应不同的Node版本范围。先在CLI里执行这两个命令看看当前版本：

  node -v
  npm -v
  

  然后对照你项目里Angular的版本（看package.json里的@angular/core版本），比如Angular 16+需要Node.js 16.14.0及以上。版本不匹配的话，要么升级/降级Node，要么用nvm（Node版本管理器）来切换合适的版本，避免踩版本兼容的坑。

• 清理依赖缓存，重新安装依赖
  很多时候启动失败是因为依赖包安装不完整或者缓存出问题了，咱试试这几步：

  # 删除node_modules文件夹和锁文件
  rm -rf node_modules package-lock.json
  # 重新安装依赖
  npm install
  

  如果你用的是yarn包管理器，就删yarn.lock，然后执行yarn install。

• 检查全局和本地Angular CLI版本是否一致
  全局CLI和项目本地CLI版本不一致也会导致奇怪的错误。执行ng version看看输出里的「Global Angular CLI」和「Local Angular CLI」版本，如果不一样，要么把全局CLI升级到本地版本：

  npm install -g @angular/cli@<你的本地版本号>
  

  要么把项目本地CLI更新到全局版本，这样版本统一后问题大概率能解决。

• 排查端口是否被占用
  ng server默认用4200端口，如果这个端口被其他程序占用了，启动肯定会失败。咱可以换个端口试试：

  ng server -o --port 4201
  

  或者杀掉占用4200端口的进程：Windows下用netstat -ano | findstr :4200找到PID，再用taskkill /F /PID <找到的PID>杀掉；Mac/Linux下用lsof -ti:4200 | xargs kill -9直接杀掉占用进程。

• 如果以上都没用，得看具体错误信息
  要是上面的步骤都没解决问题，你得把CLI里弹出的具体错误内容（或者你提到的图片里的错误细节）贴出来，比如是模块找不到、TypeScript编译错误，还是其他类型的报错，针对性处理才更快。

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