Multiline git commit message in VSCode

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

enter image description here


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.profiles.windows": {
        "Git Bash": {
            "source": "Git Bash"
        }
    },
    "terminal.integrated.defaultProfile.windows": "Git Bash",
    
  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., combined with language-specific settings in the settings.json file in the executable's folder, e.g.:

    "[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

vs code commit

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.


For a convenient multiline commit message editor, install an extension called "adam-bender.commit-message-editor".


You can configure git to use any editor. For example, if you like to use VSC editor for long commit messages, you can run the below command in the terminal:

git config --global core.editor "code --wait"

and then just commit it without "-m"

it will open a commit edit tab on VS code where you type in your long commit message. When you close that tab your commit message will be added

note: you might need to run Control + shift + P to open your command palette and install code

Git instruction for other editors: https://git-scm.com/book/en/v2/Appendix-C%3A-Git-Commands-Setup-and-Config