VSCode 可用 Podman 替代 Docker，但需停用 Docker 扩展、配置 "remote.containers.containerRuntime": "podman"、启动 podman system service 并指定正确 socket 路径，否则容器面板空白、远程连接失败、Dev Container 启动报错。
VSCode 能直接用 Podman 替代 Docker，但必须关掉 Docker 扩展、改配置、手动指定 podman 二进制路径——否则容器面板空白、远程连接失败、Dev Container 启动报错。
VSCode 容器扩展不认 Podman 的根本原因
官方 Remote - Containers 扩展默认只探测 docker 命令，即使系统已装 podman，它也不会自动 fallback 或检测。你看到“Docker is not installed”或“Cannot connect to the Docker daemon”，其实不是没装容器引擎，而是 VSCode 根本没去调 podman。
- Podman 默认不监听
unix:///var/run/docker.sock，而 VSCode 容器扩展硬编码依赖该 socket 路径（除非显式覆盖） -
podman system service需要手动启动并暴露 API（类似 Docker daemon），否则podman命令行可用，但 VSCode 无法通信 - Linux 上 Podman 默认以 rootless 模式运行，但 VSCode 扩展可能尝试用 rootful socket 路径，权限和路径双双不匹配
让 Remote - Containers 扩展识别 Podman 的三步实操
不是“换一个设置就行”，而是必须组合操作：
- 停用或卸载
Docker扩展（ms-azuretools.vscode-docker可保留，但ms-vscode-remote.remote-containers是核心） - 在用户 settings.json 中强制指定容器引擎：
"remote.containers.containerRuntime": "podman"
- 确保
podman system service已后台运行：podman system service --time=0 unix:///tmp/podman.sock &
，然后在 settings.json 中补上："remote.containers.dockerSocketPath": "/tmp/podman.sock"
- Linux 用户注意：rootless Podman 默认 socket 在
$XDG_RUNTIME_DIR/podman/podman.sock，别硬写/var/run/docker.sock
Dev Container 配置文件里 podman 和 docker 的关键差异
.devcontainer/devcontainer.json 本身不区分引擎，但底层行为受 runtime 影响：
-
build.context和build.dockerfile仍可用，Podman 完全兼容 Dockerfile 语法，无需改写 - 不支持
docker-compose.yml的version: '3.8'等高级字段（Podman Compose 对 v2+ 支持有限），建议降级到2.4或改用podman-compose - 挂载宿主机路径时，rootless Podman 对
/home/xxx外的路径（如/opt）可能拒绝绑定，需加--privileged或改用userns=keep-id（不推荐） - 镜像拉取行为不同：Podman 默认不走 daemon，
pull更快但不复用 layer 缓存；若需缓存，得开podman system service并确保 VSCode 连的是它
常见报错与绕过方案
遇到这些提示，基本就是上面某步漏了：
-
Failed to connect to Docker daemon at unix:///var/run/docker.sock→ 检查remote.containers.dockerSocketPath是否指向真实运行的podman.sock，且podman system service进程活着 -
Permission denied while trying to connect to the Docker daemon socket→ rootless 用户别用/var/run/docker.sock；确认 socket 文件属主是当前用户，且umask允许读写（比如启动 service 时加--log-level=debug看实际路径） - Dev Container 启动后无终端、
docker命令不可用 →remote.containers.containerRuntime没设对，或扩展版本太老（需 v0.370.0+） - Windows WSL2 下 Podman Desktop 已安装但仍失败 → 关闭 Podman Desktop 自带的 Docker 兼容层（它会占
/var/run/docker.sock），改用原生podman system service
Podman 和 VSCode 的集成不是“即插即用”，它依赖你清楚自己用的是 rootful 还是 rootless、socket 路径在哪、以及 VSCode 扩展是否真连到了那个 socket —— 少一个环节，整个链路就断在看不见的地方。
