如何修改VS Code Dev Container配置以适配Podman替代Docker

问题背景 #

我在RHEL8桌面环境中使用VS Code的Dev Container扩展，正尝试修改配置用Podman替代Docker。VS Code的「高级容器」页面「Docker选项」里提到Podman和部分Docker功能有兼容性问题，给出了修复配置：

"runArgs": [
  "--userns=keep-id"
],
"containerEnv": {
  "HOME": "/home/node"
}

同时说明设置"HOME"后就能用"remoteUser"，因为Dev Containers会优先用这个设置而非/etc/passwd里的家目录。作为新手，我想知道这些配置该加在哪里？是VS Code设置吗？如果是，怎么找到对应设置？

配置位置及操作步骤 #

这些配置属于项目级的Dev Container设置，需要放在项目的.devcontainer配置文件中，而非全局VS Code设置，具体操作分两种情况：

1. 项目已存在.devcontainer目录 #

• 打开项目根目录下的.devcontainer/devcontainer.json文件
• 将给出的runArgs和containerEnv代码片段添加到JSON结构中（注意JSON语法规范，若文件已有其他配置项，要在相邻键值对间加逗号分隔）
• 完整配置示例：

{
  "name": "My Node.js Container",
  "image": "mcr.microsoft.com/devcontainers/javascript-node:18",
  "runArgs": [
    "--userns=keep-id"
  ],
  "containerEnv": {
    "HOME": "/home/node"
  },
  "remoteUser": "node"
}

2. 项目还没有.devcontainer目录 #

• 打开VS Code，按下F1调出命令面板
• 搜索并执行「Dev Containers: Add Dev Container Configuration Files...」命令
• 选择适配你项目的容器模板（比如Node.js、Python等），VS Code会自动在项目根目录生成.devcontainer目录和devcontainer.json文件
• 再按照第一种情况的方法，把兼容配置添加到生成的devcontainer.json里

额外提示 #

• 全局VS Code设置里虽有Dev Containers相关选项，但这里的Podman兼容配置是针对单个项目的，项目级配置更灵活，能适配不同项目的容器需求
• 添加完配置后，执行「Dev Containers: Rebuild Container」命令重新构建容器，新配置才会生效

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