Comprehensive Guide to Efficient Multi-line Indentation in Vim

Basic Multi-line Indentation Commands

In the Vim editor, indentation operations are fundamental to code editing. The >> command indents the current line, with the indentation amount determined by the shiftwidth setting. For multiple lines, numeric prefixes can be added before the command; for example, 5>> indents five lines starting from the current line. This use of numeric prefixes is characteristic of Vim's command mode and significantly enhances editing efficiency.

Indentation in Visual Mode

Visual mode offers a more intuitive approach to multi-line indentation. Enter visual line mode with V, then select multiple lines using j or k keys, and finally press > to indent. For instance, Vjj> selects the current line and the two lines below it for indentation. This method's advantage lies in precise control over the indentation range, making it ideal for handling discontinuous or specific code segments.

Advanced Code Block Indentation Techniques

For code blocks delimited by curly braces, Vim provides specialized indentation commands. Place the cursor on an opening or closing brace and use >% to indent the entire block. If the cursor is inside the block, >iB (inner Block) indents the block's content without including the boundary braces. These commands leverage Vim's text object concept to intelligently recognize code structures.

Indentation Alignment During Pasting

Maintaining indentation consistency during copy-paste operations is crucial. Using ]p instead of the regular p command for pasting automatically adjusts the pasted content's indentation to match the surrounding code. This feature is particularly useful during code refactoring or when moving code blocks, eliminating the need for manual indentation adjustments.

Detailed Indentation Configuration Parameters

shiftwidth is the core parameter controlling indentation width, determining the number of spaces added or removed per indentation operation. In the Vim configuration file, set shiftwidth=4 to define a 4-space indentation. Combined with the expandtab option, this ensures spaces are used instead of tabs for indentation, which is vital for team collaboration and cross-platform development.

Repeating Indentation Operations

Vim's . command repeats the last operation, which is highly efficient when applying the same indentation multiple times. For example, after indenting a line, moving the cursor to other positions requiring the same indentation and pressing . quickly applies the operation. This repetition mechanism significantly reduces time spent on repetitive tasks.

Practical Application Scenarios with Examples

Consider the following Python code requiring indentation adjustment:

def example_function():
print("Hello")
print("World")
if True:
print("Conditional")

To fix the indentation of these lines, enter visual mode to select lines 2-5 and perform indentation. Use V4j> to select and indent these lines, or 5>> to indent five lines starting from the current line. For more complex cases like nested code blocks, combine with text object commands such as >i{ for precise control.

Indentation Best Practices

In practical development, it is recommended to configure uniform indentation settings in the .vimrc file:

set expandtab
set shiftwidth=4
set softtabstop=4
set autoindent
filetype plugin indent on

These settings ensure consistent indentation across file types and leverage Vim's filetype detection to automatically apply appropriate indentation rules. For team projects, unified indentation configurations prevent formatting conflicts and improve code readability.