文章标题：[Docker避坑] 为什么我的配置文件被 Vim 打开后变成了目录列表 (Netrw)？

日期： 2025-12-03
作者： 刘伟清
分类： Docker, Linux, 运维
标签： #Docker #Vim #Troubleshooting #Linux

---

问题现场

今天在服务器上部署容器时，遇到一个非常诡异的现象。

我准备修改一个配置文件 config.js，于是习惯性地输入了命令：

vim /root/auto_checkin/config.js

结果 Vim 并没有打开我预期的文本编辑界面，而是显示了一个蓝色的目录列表，顶部写着 “Netrw Directory Listing”，如下图所示：

我当时的第一反应是：“我明明输入的是文件名，为什么 Vim 把它当成目录打开了？”

退出 Vim 后，我用 ls -l 查看了一下文件属性：

drwxr-xr-x 2 root root 4096 Dec 3 10:00 config.js

开头竟然是 d！系统真的把它识别成了一个文件夹（Directory），而不是文件。

原因分析

经过排查，发现这是 Docker 挂载卷（Volume）机制 导致的经典误操作。

我在启动容器时，使用了类似这样的 -v 挂载命令：

docker run -d \
  -v /root/auto_checkin/config.js:/app/config.js \
  --name my_container \
  image_name

问题的根源在于：
当执行这条命令时，宿主机路径 /root/auto_checkin/config.js 并不存在。

Docker 的逻辑是：

如果用户指定了挂载路径，但宿主机上找不到这个源路径，Docker 守护进程会默认自动创建一个空文件夹来代替它，而不是创建一个空文件。

所以，我的 config.js 就这样一个空文件夹，被挂载到了容器里。当我试图用 Vim 编辑它时，Vim 识别到它是目录，自然就调用了自带的文件管理器插件（Netrw）来显示目录内容。

解决方案

既然知道了原因，解决起来就很快了。我们需要删除这个错误的文件夹，并手动创建一个正确的文件。

1. 删除错误的文件夹
首先确保没有容器正在占用它（或者直接暴力删除）：

rm -rf /root/auto_checkin/config.js

2. 手动创建空文件
在启动容器之前，必须先保证宿主机上有这个文件：

# 确保目录存在
mkdir -p /root/auto_checkin/

# 创建文件
touch /root/auto_checkin/config.js

3. 重新填写内容并启动
现在可以用 Vim 正常编辑了：

vim /root/auto_checkin/config.js

编辑完成后，再次运行 docker run 命令，一切恢复正常。

经验总结

在使用 Docker 的 -v 参数挂载单个文件（而不是目录）时，一定要遵循一个原则：

先 Touch，后 Run。

永远不要指望 Docker 帮你自动创建文件。如果宿主机文件不存在，Docker 永远只会给你一个空目录，从而导致程序报错或无法编辑。