How do you search for a text in Vim?
Press the / key, type your search text and press enter. This is just like the less command.
But this method of finding text doesn't allow you to replace the found result.
Let me share how you can find and replace in Vim.
The above command will run a case-insensitive search to find all the occurrences of your search term (foo) with the new term (bar). With the flag c, it asks to confirm before replacing any substitution.
Let me go in detail and explain things a more clearly.
Using the substitute command to find and replace text in Vim
I guess you already know that to run a command in Vim, you must be in the normal mode (also known as command mode). Press Esc key to enter this mode.
Vim has a handy command
:substitue, can also be used with the shorter version
Below is the general syntax of the substitute command:
Let's break down this syntax. Anything between the square brackets '' is optional.
range: This part of the syntax can be used if you want the substitution between said lines. If you do not mention a range, it will only substitute text on the current line. (I have shared a table for range)
pattern: Here is where you specify the text that you want to replace.
string: This is the string which will replace the pattern.
flags: To replace all occurrences of the search pattern, use the
gflag. You can specify if you want the match to ignore case, use
iflag. To manually confirm each search and replace operation, use the
count: Number of lines to replace text in.
|x||Line number x|
|.,+x||From current line until additional x lines|
Examples of finding and replacing in Vim
Let's go over a few examples that demonstrate the use of the substitute command in Vim.
Below is the screenshot of the file I will be using to demonstrate the usage of substitute command in Vim.
Basic text replacement
For this example, I made sure that the string 'Hello' occurred several times in at least one line and multiple times in the file.
I want to replace 'Hello' with the string 'HI'. Below is the Vim command to do that:
Replace with confirmation
To substitute text, but want a confirmation every time you do it, you can use the
c in the substitute command.
As you can see from the video, Vim asks me for a confirmation every single time before it substitutes a pattern.
You also have a prompt that looks like the following line:
replace with HI (y/n/a/q/l/^E/^Y)?
The options from the prompt have the following meaning:
- y: yes
- n: no
- a: all
- q: quit without substituting, but it does not undo once you have already substituted text
- l: substitute this and exit (think of 'last')
- ^E: Scroll up (does not work in
- ^Y: Scroll down (does not work in
When you want to substitute text regardless that if it is in uppercase or lowercase, in that case (haha) you should use the
i flag in the substitute command.
If you notice, all occurrences of 'hello' or 'Hello' and even 'hELLO' are replaced with 'HI'. This is a case insensitive pattern substitution.
Every 'hello' is replaced with 'HI' even though most 'hello' have an uppercase 'H' in it.
Replace text in single line in Vim
To substitute text in a single line, we need to specify the range that limits the scope of substitution to current line.
For that, it is better to use the
. range descriptor.
As you can see, only the pattern in the first line got substituted because I used the period '.' range descriptor.
Bonus tip: Using a different delimiter
Looking at the syntax of substitute command, I mentioned that the pattern and string are separated by a forward slash '/'.
But what if you had text with lots of forward slashes in pattern/string, like a path, that repeated everywhere in the file? Escaping forward slashes can be tedious and it can be easily missed sometimes.
So, instead of using the forward slash character as a delimiter, you can use a different delimiter instead.
A few delimiter characters that I have seen being used are
Here is a gif that shows demonstration of using
@ as a delimiter instead of
Substituting text can be a common occurrence and Vim has you covered with a powerful way to search and replace pattern with a string. You can even mix regex in Vim's substitution command.
If you are interested in learning more than just the Vim Basics, I highly recommend using this program by Jovica Ilic.