VSCode Dev Container无法正确加载ms-vscode.js-debug扩展求助

问题概述 #

使用node:alpine作为基础镜像搭建Dev Container后，容器和Compose运行正常，但执行任何node或npm命令（如npm install）时，会抛出MODULE_NOT_FOUND错误，提示找不到/root/.vscode-server/data/User/workspaceStorage/xxx/ms-vscode.js-debug/bootloader.js。禁用VS Code自动附加功能可暂时规避报错，但手动调试Node进程时仍会出现Error listing processes: process terminated with exit code: 1的提示。切换为Debian基础镜像则无此问题，推测与Alpine Linux的特性相关。

相关配置文件如下：

devcontainer.json #

{
  "dockerComposeFile": ["./compose.dev.yml"],
  "service": "frontend",
  "shutdownAction": "stopCompose",
  "workspaceFolder": "/workspaces/frontend",
  "customizations": {
    "vscode": {
      "extensions": [
        "aaron-bond.better-comments",
        "streetsidesoftware.code-spell-checker",
        "ms-azuretools.vscode-docker",
        "mikestead.dotenv",
        "GitHub.copilot",
        "mhutchie.git-graph",
        "GraphQL.vscode-graphql",
        "GraphQL.vscode-graphql-syntax",
        "rome.rome",
        "svelte.svelte-vscode",
        "redhat.vscode-yaml"
      ]
    }
  }
}

compose.dev.yml #

version: "3.9"
services:
  frontend:
    build: .
    volumes:
      - workspace-volume:/workspaces
volumes:
  workspace-volume:

Dockerfile #

FROM node:alpine
RUN npm install -g npm@latest

RUN apk -U upgrade && apk add git vim zsh curl openssh

RUN sed -i -r 's|bin/ash|bin/zsh|g' /etc/passwd

RUN curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh | sh

原因分析 #

1. libc兼容性差异：Alpine使用musl libc，而Debian使用glibc，VS Code的JS Debug扩展部分依赖可能未完全适配musl，导致路径解析错误。
2. 非持久化的VS Code数据目录：容器未持久化/root/.vscode-server/data目录，每次启动会生成新的随机workspaceStorage子目录，调试器无法定位到正确的bootloader.js路径。
3. Shell切换影响环境变量：将默认Shell从ash改为zsh后，可能干扰了VS Code Server的环境变量传递，导致扩展路径识别异常。

解决方案 #

方案1：安装glibc兼容层（推荐） #

为Alpine添加glibc兼容层，解决扩展依赖的兼容性问题：
修改Dockerfile，在apk upgrade前添加libc6-compat安装命令：

FROM node:alpine
RUN npm install -g npm@latest

# 安装glibc兼容层，解决JS Debug扩展的兼容性问题
RUN apk add --no-cache libc6-compat

RUN apk -U upgrade && apk add git vim zsh curl openssh

RUN sed -i -r 's|bin/ash|bin/zsh|g' /etc/passwd

RUN curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh | sh

重新构建容器后，JS Debug扩展应能正常识别路径，预加载脚本不再报错。

方案2：禁用Node预加载脚本（快速临时修复） #

通过环境变量阻止Node加载不存在的预加载脚本，解决日常命令执行报错：
在devcontainer.json中添加remoteEnv配置：

{
  "dockerComposeFile": ["./compose.dev.yml"],
  "service": "frontend",
  "shutdownAction": "stopCompose",
  "workspaceFolder": "/workspaces/frontend",
  "remoteEnv": {
    "NODE_PRELOAD": ""
  },
  "customizations": {
    "vscode": {
      "extensions": [
        "aaron-bond.better-comments",
        "streetsidesoftware.code-spell-checker",
        "ms-azuretools.vscode-docker",
        "mikestead.dotenv",
        "GitHub.copilot",
        "mhutchie.git-graph",
        "GraphQL.vscode-graphql",
        "GraphQL.vscode-graphql-syntax",
        "rome.rome",
        "svelte.svelte-vscode",
        "redhat.vscode-yaml"
      ]
    }
  }
}

注意：此方法会禁用所有Node预加载脚本，包括调试器的预加载逻辑，手动调试时可能需要重新配置调试器路径。

方案3：持久化VS Code Server数据目录 #

将/root/.vscode-server/data挂载为持久化Volume，保留workspaceStorage的目录结构：
修改compose.dev.yml：

version: "3.9"
services:
  frontend:
    build: .
    volumes:
      - workspace-volume:/workspaces
      # 新增：持久化VS Code Server的data目录
      - vscode-server-data:/root/.vscode-server/data
volumes:
  workspace-volume:
  vscode-server-data:

这样每次启动容器时，workspaceStorage的目录会保持一致，调试器能正确找到bootloader.js文件。

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