Ubuntu环境下Angular11升级至13及构建报错问题求助

• 版本兼容性不匹配：Windows环境使用Angular 11 + Node 14.15.3，Ubuntu环境全局安装的是Angular CLI 13 + Node 12.22.7，Node版本不符合Angular 13的最低要求，且全局CLI版本与项目本身的Angular版本跨度过大，直接升级会出现依赖冲突。
• 未安装项目本地依赖：Ubuntu环境下未执行npm install安装项目package.json中声明的依赖，导致ng update检测到0个依赖、构建时提示模块找不到。
• 升级逻辑错误：Angular大版本升级需要按照版本顺序依次升级，且必须先完成本地依赖安装后再执行升级操作，不能跨版本直接升级。

方案1：保持与Windows环境版本一致（推荐，避免代码兼容问题） #

1. 卸载Ubuntu全局的高版本Angular CLI：npm uninstall -g @angular/cli
2. 清理npm缓存避免残留冲突：npm cache clean --force
3. 安装和Windows环境完全一致的全局CLI版本：npm install -g @angular/cli@11.0.5
4. 切换到项目根目录，删除可能损坏的依赖文件：rm -rf node_modules package-lock.json
5. 安装项目本地所有依赖：npm install
6. 验证功能正常：先执行ng --version确认版本匹配，再执行ng build验证构建流程正常。

方案2：确需升级到Angular 13的操作步骤 #

注意：升级前请备份所有项目代码，避免语法兼容问题导致业务代码不可用

1. 先将Ubuntu的Node版本升级到14.15.x及以上，满足Angular 13的版本要求
2. 全局安装Angular CLI 13：npm install -g @angular/cli@13
3. 切换到项目根目录，先完成当前版本依赖安装：rm -rf node_modules package-lock.json && npm install
4. 按大版本顺序依次升级，每步升级后验证构建正常再走下一步：
   • 升级到Angular 12：ng update @angular/core@12 @angular/cli@12 @angular/cdk@12，完成后执行ng build验证
   • 升级到Angular 13：ng update @angular/core@13 @angular/cli@13 @angular/cdk@13，完成后执行npm install && ng build验证

Podman容器化Dockerfile参考 #

采用多阶段构建，减小最终镜像体积：

# 构建阶段：使用和项目匹配的Node镜像，以Angular 11为例
FROM node:14.15.3-alpine as builder
WORKDIR /app
# 优先复制依赖文件，利用镜像缓存加速构建
COPY package*.json ./
RUN npm ci
# 复制所有项目文件执行生产构建
COPY . .
RUN npm run build --prod

# 运行阶段：使用Nginx提供静态资源服务
FROM nginx:alpine
# 将构建产物复制到Nginx静态资源目录，将<你的项目名>替换为实际的dist下的文件夹名
COPY --from=builder /app/dist/<你的项目名> /usr/share/nginx/html
# 若项目使用Angular路由，可复制自定义Nginx配置文件开启try_files规则
# COPY nginx.conf /etc/nginx/conf.d/default.conf
EXPOSE 80

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