在日常开发中，我们经常需要在服务器上直接使用 vi 或 vim 修改代码。当需要批量替换包含大量斜杠（/）的路径时，很多新手容易踩坑。
本文以实际场景为例：将 /data/web/quanzhi5/trunk/dist/dev/ 批量替换为 /data/web/quanzhi5/trunk/dist/dev-ai/，总结一套高效且安全的 Vim 替换逻辑。
一、 痛点分析
在 vim 中，默认的替换命令语法是：
vim
:%s/旧文本/新文本/g其中 / 是默认的分隔符 。但我们要替换的内容是路径 /data/...，里面充满了 /。如果不做特殊处理，Vim 会直接报错。因此，我们的核心逻辑是：更换分隔符，避免转义地狱。
二、 最佳实践：更换分隔符（强烈推荐）
我们可以使用 # 或者 | 作为替代分隔符，这样路径中的 / 就可以原样书写，无需转义。
具体操作：
按 Esc 确保处于命令模式，输入以下命令并回车：
vim
:%s#/data/web/quanzhi5/trunk/dist/dev/#/data/web/quanzhi5/trunk/dist/dev-ai/#g(或者使用 | 作为分隔符：: %s|/data/...|/data/...|g)
命令拆解说明：
-
%：表示在整个文件范围内进行替换（不加%则只替换当前行）。 -
s：substitute（替换）的缩写。 -
#：自定义的命令分隔符 （替代默认的/，避免路径中的斜杠冲突）。 -
/data/web/.../dev/：你要查找的旧路径。 -
/data/web/.../dev-ai/：你要替换成的新路径。 -
g：global，表示替换每行中所有 匹配项（不加g则只替换每行第一个匹配项）。
三、 备选方案：转义斜杠（不推荐）
如果你非要使用默认的 / 做分隔符，你就必须把路径里的每一个 / 都写成 \/，这会显得非常冗长且容易写错：
vim
:%s/\/data\/web\/quanzhi5\/trunk\/dist\/dev\//\/data\/web\/quanzhi5\/trunk\/dist\/dev-ai\//g⚠️ 注意：这种方式极易漏掉转义符，导致语法错误，强烈建议采用第二种更换分隔符的方法。
四、 🛡️ 安全操作提示（防翻车指南）
在生产环境直接替换代码有风险，建议按照以下安全步骤操作：
1. 先预览，逐个确认替换（推荐）
在命令末尾加上 c（confirm）参数，Vim 会在每次替换前询问你：
vim
:%s#/data/web/quanzhi5/trunk/dist/dev/#/data/web/quanzhi5/trunk/dist/dev-ai/#gc执行后会进入交互模式：
-
按
y：替换当前这个。 -
按
n：跳过当前这个。 -
按
a：替换全部（all）。 -
按
q：退出替换。 -
按
l：替换当前并退出（替换这个后停止）。
2. 替换后的补救
-
如果替换错了，在未保存前 ，按
u（undo）即可撤销上一步操作。 -
确认无误后，输入
:wq保存并退出。
3. 精准匹配的陷阱（关于尾部斜杠）
在上述命令中，我们查找的是 /dev/（带了尾部斜杠），这是一个非常安全的匹配。
如果你在编写命令时去掉了尾部斜杠 （比如查找 dev 替换为 dev-ai），那么它可能会把 development 错误地替换成 development-ai。因此，带完整路径和尾部斜杠是防止误伤的绝佳习惯。
五、 总结速查
| 场景 | 命令示例 |
|---|---|
| 全文件替换（路径） | :%s#旧路径#新路径#g |
| 全文件替换（安全确认） | :%s#旧路径#新路径#gc |
| 撤销上一步操作 | u |
| 保存并退出 | :wq |
| 不保存强制退出 | :q! |