Comprehensive Guide to Creating Files in the Same Directory as the Open File in Vim

Fundamental File Creation Mechanisms in Vim

In the Vim editor, creating new files follows the same underlying logic as editing existing files. When a user needs to generate a new file, they can initiate the operation using commands such as :edit filename or :split filename. These commands initialize a buffer with the specified filename, but the file is not yet physically written to disk. Users can input desired content into the buffer, then use the :write command to persist the buffer contents to the filesystem. This design reflects Vim's buffer-centric philosophy—all editing operations first affect buffers in memory, and only explicit saving impacts disk files.

Vim Directory System and Path Referencing

Vim maintains a concept of current working directory, similar to the current directory in a command-line terminal. Users can view the current directory via the :pwd command, and all relative file paths are resolved based on this directory. To simplify operations within the directory of the open file, Vim provides a powerful system of filename modifiers. The % symbol represents the full file path of the current buffer, while the :h modifier extracts the directory portion of that path (i.e., removing the filename). For example, if the current file path is /home/user/projects/main.c, then %:h resolves to /home/user/projects. Complete documentation for these modifiers is available via :help filename-modifiers.

Core Creation Method: Using Path Modifiers

Based on the aforementioned path system, the standard method for creating a new file in the same directory as the open file involves combining filename modifiers. The specific operational workflow is as follows: first execute the :e %:h/filename command, where filename is replaced with the target filename. This command creates a buffer pointing to the new file in the specified directory. The user can then input file content, and finally save the file via the :w command. For instance, to create a new file named config.yaml in the same directory as the current file, the complete command sequence is:

:e %:h/config.yaml
[Input file content]
:w

This approach eliminates the need for users to manually type full paths, reducing the risk of path errors while maintaining operational simplicity.

Alternative Approach: Automatic Directory Switching Configuration

For users who frequently need to operate within the current file's directory, Vim offers the autochdir configuration option. By adding the :set autochdir directive to the ~/.vimrc configuration file, Vim automatically changes the working directory to that of the current file each time the buffer is switched. With this feature enabled, the file creation process simplifies to:

:e filename
:w

The advantage of this method is more intuitive commands, but it is important to note that automatic directory switching may affect certain plugins or scripts that rely on a fixed working directory. Users should weigh the benefits based on their actual workflow.

Vim Autonomous Learning Methodology

The key to mastering Vim's advanced features lies in effectively utilizing its built-in help system. Vim's :help command provides a comprehensive documentation system covering detailed explanations of all commands, options, and functions. The help documentation employs a hypertext structure, allowing users to deeply explore specific topics through tag navigation, text search, and contextual links. A recommended learning path includes: first completing the basic tutorial via :help tutorial, then systematically studying editor concepts through :help user-manual, and finally using :help [keyword] for precise queries on specific issues. By combining practical operations with document reading, users can gradually develop a deep understanding of Vim.