Docker下TypeScript项目node_modules软链接失效问题求助

问题核心原因 #

报错是两个层面的问题共同导致的：

1. 你当前的卷配置会把本地项目全量覆盖容器内的/usr/src/app目录，容器构建阶段创建的node_modules软链接会被本地目录直接覆盖，导致容器内运行时也无法读取到依赖，同时本地没有node_modules目录，VSCode默认读取本地文件自然找不到类型声明。
2. VSCode默认调用本地的TypeScript语言服务，本地未安装依赖的情况下无法索引到对应类型文件。

解决方案 #

1. 修正卷挂载配置，保留容器内的node_modules #

修改你的docker-compose.yml的volumes配置，新增匿名卷挂载node_modules目录，优先级高于本地绑定挂载，不会被本地目录覆盖：

volumes:
  - .:/usr/src/app
  - /usr/src/app/node_modules # 新增这行即可

你原Dockerfile中的mv node_modules ../ && ln -sf ../node_modules node_modules逻辑可以保留，无需修改。

2. 配置VSCode使用容器环境，本地无需安装依赖 #

要实现本地完全不装依赖也能正常获得编辑器提示，使用VSCode的Dev Containers扩展即可：

• 给VSCode安装Dev Containers扩展
• 启动容器后，点击VSCode左下角的远程连接按钮，选择「在容器中打开文件夹」，选择当前项目目录
• 连接完成后，VSCode会直接调用容器内的TypeScript语言服务，读取容器内的node_modules文件，所有模块找不到的报错会自动消失

验证操作 #

配置完成后执行以下步骤即可正常使用：

1. 重新构建镜像：docker compose build
2. 启动容器：docker compose up -d
3. 用Dev Containers打开项目即可正常开发，全程不需要在本地执行npm install

后续新增依赖时，直接在容器终端执行npm install或者修改package.json后重新构建镜像即可，本地不需要做任何操作。

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