Multiline git commit message in VSCode

Question

When commiting files using VSCode\'s Git integration, is there any way of writing a multiline commit message, or am I limited to a single line only?

As of now, VSCo

Answer 1

While Benjamin Pasero's answer is definitely viable, do you really want to compose non-trivial commit messages within that bare-bones textbox built into the sidebar? I would rather write my commit messages within a VS Code tab instead, unlocking the editor's full power.

Setup

1. Set VS Code's default terminal to Git Bash (optional and only relevant if using Windows) by putting something like the following in your VS Code settings. Actually, just do it via the GUI instead, as stated in this answer. (Note that you can execute cmd or powershell from that terminal and bash to get back.)

   "terminal.integrated.shell.windows": 
       "C:\\ProgramFiles\\Git\\bin\\bash.exe"
   

2. Set Git's default editor to VS Code, either by selecting VS Code as the default editor during Git installation or by putting something like the following in your global .gitconfig file. See this question for more detail.

   [core]
       editor = 'C:\\Users\\your user dir\\AppData\\Local\\Programs\\Microsoft VS Code\\Code.exe' --wait
   

3. Set VS Code up for a more enjoyable commit experience via extensions like Rewrap, Code Spell Checker, MetaGo, etc., as well as language-specific settings like:

   "[git-commit]": {
       "editor.rulers": [72, 50],
       "editor.wordWrap": "off"
   }
   

Usage

1. If the VS Code terminal isn't already visible, hit ctrl+` to bring it up.

2. Use it to execute git commit -a or whatever.

3. A new tab will appear in VS Code, where you can type in your commit message.

4. When you are done, save and close that tab to complete the commit, or close the tab without saving to abort it. You can hit ctrl+` again to hide the terminal.

Action Shot

Regarding using Rewrap with multiple rulers:

Just press Alt+q multiple times to wrap to each ruler in turn. The ruler chosen is then remembered for that document for the rest of the session. It cycles through the rulers in the order in which they appear in settings; so if you have a most commonly used ruler, you probably want to put that first.

See the documentation for more detail.

Answer 2

With the 0.5.0 release we now support multi line commit messages. Just hit the Enter key to add new lines.