Docker卷映射报错：Angular CLI在工作区外无法执行命令

Docker版本：20.10.21

不带卷映射的docker run命令可正常启动Angular应用，但尝试通过卷映射共享源码时，出现错误提示：在工作区外运行Angular CLI时，此命令不可用

相关命令 #

• 正常执行的命令：

  docker run -p 4200:4200  angular-app 
  

• 执行失败的命令：

  docker run -p 4200:4200 -v ${pwd}:/web-app/ -v /web-app/node_modules/ angular-app
  

问题原因 #

1. 本地${pwd}目录并非合法的Angular工作区（缺少angular.json、package.json等核心配置文件），挂载后容器内/web-app目录没有完整的Angular项目结构，导致CLI无法识别工作区。
2. 挂载本地目录时覆盖了容器内原有的完整项目文件，使得容器内的/web-app不满足Angular CLI的工作区要求。

解决办法 #

1. 确认本地目录为Angular工作区：
   在本地执行ng version，能正常输出版本信息则说明目录合法；若不行，先通过ng new创建项目，或切换到已有的Angular项目根目录。
2. 匹配容器工作目录：
   确保本地目录挂载路径与Dockerfile中WORKDIR指定的路径一致（比如Dockerfile用了WORKDIR /web-app，本地就必须是Angular项目根目录）。
3. 保留容器内node_modules：
   当前使用的-v /web-app/node_modules/匿名卷设置正确，可避免本地目录覆盖容器内依赖，无需调整。
4. 重构镜像确保项目完整：
   若镜像内项目文件不完整，重新构建镜像，确保Dockerfile已将所有Angular项目文件（含配置文件）复制到容器的工作目录中。

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