.gitconfig file structure - Commands & Configuration

Introduction

The .gitconfig file stores settings that control how Git behaves on your computer. It helps you customize Git to work the way you want, like setting your name, email, and preferred text editor.

When you want to set your name and email so your commits show who made them

When you want to change the default text editor Git uses for commit messages

When you want to set up aliases to shorten long Git commands

When you want to configure Git to use colors in the terminal for easier reading

When you want to set global settings that apply to all your Git projects

Config File - .gitconfig

.gitconfig

[user]
	name = Jane Doe
	email = [e-mail]
[core]
	editor = nano
[color]
	ui = auto
[alias]
	st = status
	co = checkout

[user] sets your name and email for commits.

[core] sets core Git options like the default editor.

[color] controls color output in the terminal.

[alias] defines shortcuts for Git commands.

Commands

Sets your name globally so all your commits use this name.

Terminal

git config --global user.name "Jane Doe"

Expected Output

No output (command runs silently)

→

--global - Apply setting for all repositories on your computer

Sets your email globally so all your commits use this email.

Terminal

git config --global user.email "[e-mail]"

Expected Output

No output (command runs silently)

→

--global - Apply setting for all repositories on your computer

Sets nano as the default editor for Git commit messages.

Terminal

git config --global core.editor nano

Expected Output

No output (command runs silently)

→

--global - Apply setting for all repositories on your computer

Creates an alias 'st' for the 'status' command to save typing.

Terminal

git config --global alias.st status

Expected Output

No output (command runs silently)

→

--global - Apply setting for all repositories on your computer

Shows all Git settings currently active, including those in .gitconfig.

Terminal

git config --list

Expected Output

user.name=Jane Doe

user.email=[e-mail]

core.editor=nano

color.ui=auto

alias.st=status

alias.co=checkout

Key Concept

If you remember nothing else from this pattern, remember: the .gitconfig file stores your personal Git settings that apply globally or per project.

Common Mistakes

Editing the .gitconfig file manually without proper syntax

Git may fail to read the file or ignore settings if the format is wrong

Use 'git config' commands to safely update settings or carefully follow the INI file format

Setting user.name and user.email only locally and forgetting global settings

Your commits in other repositories may not have your name and email set correctly

Use --global flag to set user.name and user.email for all repositories unless you want different info per repo

Summary

The .gitconfig file holds your Git settings like name, email, editor, and aliases.

Use 'git config --global' commands to set or change these settings safely.

Check your current settings anytime with 'git config --list'.