共享VS Code开发容器时启动新容器报错，寻求解决方法

我正与协作者共享VS Code开发容器项目，对方需要我的开发环境及部分项目文件，执行以下步骤后遇到报错：

1. 导出内容的步骤 #

• 复制工作区中需共享的部分

  rsync -av --exclude 'irrelevant_content' my_vscode_project/ my_collab_share/
  

• 备份开发容器以共享

  docker commit my_dev_container my_shared_image
  

2. 测试访问新容器的步骤 #

• 使用刚创建的镜像启动新容器

  cd my_collab_share
  docker run -v $pwd:/workspaces/my_vscode_project my_shared_image
  # 输出：Container started
  

• 在VS Code中打开新容器
  1. 点击Docker标签页
  2. 点击Individual Containers -> my_shared_image时执行失败，日志报错：

  [5084 ms] Command in container failed: mv -n /home/vscode/.vscode-server/bin/92da9481c0904c6adfe372c12da3b7748d74bdcb_1678478748544/* /home/vscode/.vscode-server/bin/92da9481c0904c6adfe372c12da3b7748d74bdcb && rmdir /home/vscode/.vscode-server/bin/92da9481c0904c6adfe372c12da3b7748d74bdcb_1678478748544
  [5084 ms] rmdir: failed to remove '/home/vscode/.vscode-server/bin/92da9481c0904c6adfe372c12da3b7748d74bdcb_1678478748544': Directory not empty
  [5085 ms] Exit code 1
  

这个错误是因为VS Code Server在容器内的临时目录清理失败——mv -n不会移动隐藏文件（比如.gitkeep或系统隐藏文件），导致目录非空。以下是几种实用解决办法：

方法1：提交容器前清理VS Code Server临时文件 #

在执行docker commit之前，先进入运行中的容器清理相关目录，避免残留文件被打包进镜像：

# 进入容器
docker exec -it my_dev_container bash

# 清理VS Code Server的临时目录（匹配带下划线的临时文件夹）
rm -rf /home/vscode/.vscode-server/bin/*_*
exit

# 重新提交镜像
docker commit my_dev_container my_shared_image

重新提交的镜像不会有遗留的临时目录，启动新容器后VS Code会自动初始化Server文件，避免冲突。

方法2：启动容器时挂载空目录覆盖VS Code Server目录 #

通过挂载本地空目录，强制VS Code在新目录下重新生成Server组件，绕过原有镜像的残留问题：

# 先创建本地空目录
mkdir -p ./vscode-server

# 启动容器时挂载该目录
cd my_collab_share
docker run -v $pwd:/workspaces/my_vscode_project -v $pwd/vscode-server:/home/vscode/.vscode-server my_shared_image

方法3：手动修复运行中的容器 #

如果已经启动了容器，直接进入容器手动清理目录：

# 进入报错的容器（替换为你的容器ID或名称）
docker exec -it <container_id> bash

# 查看目录内的隐藏文件
ls -la /home/vscode/.vscode-server/bin/92da9481c0904c6adfe372c12da3b7748d74bdcb_1678478748544/

# 删除所有文件（包括隐藏文件）
rm -rf /home/vscode/.vscode-server/bin/92da9481c0904c6adfe372c12da3b7748d74bdcb_1678478748544/*

# 执行目录删除
rmdir /home/vscode/.vscode-server/bin/92da9481c0904c6adfe372c12da3b7748d74bdcb_1678478748544

清理完成后，重新在VS Code中连接容器即可。

方法4：改用Dev Container配置文件共享（长期推荐） #

直接共享VS Code的.devcontainer配置目录，让协作者基于配置文件重新构建容器，这是更可靠的长期方案：

• 确保项目根目录有.devcontainer文件夹（包含devcontainer.json和Dockerfile等配置文件）
• 将.devcontainer和共享的项目文件一起发给协作者
• 协作者在VS Code中打开项目，点击左下角的"打开远程窗口"按钮，选择"在容器中重新打开"，VS Code会自动构建与你一致的开发环境

这种方式避免了镜像提交带来的文件残留问题，也方便后续环境同步更新。

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