Circle CI运行Angular项目执行ng命令报Unexpected token )错误如何解决

问题根因 #

你使用的circleci/node:6-browsers镜像搭载的是Node.js 6.x版本，该版本早已结束生命周期，无法兼容当前主流版本的Angular CLI：

• 最新版Angular CLI最低要求Node.js 14.20.0以上版本
• 即使是较早发布的Angular CLI v7，最低要求也是Node.js 10.13版本

Node 6不支持ES2017及之后的JS语法特性（比如函数参数的尾随逗号），所以执行ng相关命令时会抛出你遇到的SyntaxError语法错误，和你使用npm还是yarn作为包管理器没有关系。

解决方案 #

按以下步骤修改你的Circle CI配置即可解决：

• 替换基础镜像：将docker字段下的镜像从circleci/node:6-browsers替换为和你项目Angular版本匹配的高版本Node镜像，比如常用的circleci/node:18-browsers可适配Angular v14到v17的所有版本。
• 移除非必要配置：
  • 不要使用sudo全局安装Angular CLI，优先调用项目本地安装的CLI版本，直接用npx ng（npm场景）或yarn ng（yarn场景）执行命令即可，避免全局版本和项目依赖版本冲突。
  • 移除ng update相关步骤，该命令用于升级项目的Angular依赖版本，CI环境无需执行版本变更操作。
• 特殊场景兼容：如果你必须保留Node 6环境，则安装Angular CLI时指定兼容版本@angular/cli@1.7.4，不要使用latest标签拉取最新版本。

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