Lesson 15 of 20

6 mins read

.gitignore Rules & .gitattributes Cross-Platform Handling

In Plain English

.gitignore specifies intentionally untracked patterns (node_modules/, .env, *.o, target/) to keep repositories clean and secure. .gitattributes enforces consistent line endings (LF vs CRLF across Windows/Linux/macOS) and designates binary files for diff engines.

The Mental Model

".gitignore is the "Do Not Disturb" sign on a hotel room door; .gitattributes is the universal power outlet adapter ensuring equipment from any country plugs in seamlessly without frying the circuits."

Deep Dive: How It Works

.gitignore Syntax: *.log (all logs), build/ (directory), !important.log (negation exception), **/dist (wildcard recursion).

.gitattributes EOL: * text=auto eol=lf standardizes clean Unix LF line endings across all operating systems.

Diff Drivers: Designates custom diff engines for PDFs, lockfiles, or minified bundles.

Syntax Blueprint

# .gitignore
node_modules/
.env
*.o

# .gitattributes
* text=auto eol=lf

Ignore build artifacts and secrets while standardizing repository line endings.

Core Rules to Remember

Secret Leak Prevention: Always include .env and private keys (*.pem) in .gitignore before the first commit.

Untracking Cached Files: If a file was already committed, git rm --cached <file> un-tracks it while keeping it on disk.

CRLF Normalization: .gitattributes prevents phantom whitespace diffs caused by Windows CRLF carriage returns.

Common Beginner Traps & How to Fix Them

Mistake:Adding a file to .gitignore after it has already been committed.

Why it happens: Git continues tracking files that are already present in the index.

How to fix: Run git rm --cached <file> and commit the removal.

Pro Tip: Use global ignore templates with git config --global core.excludesfile ~/.gitignore_global for OS junk (.DS_Store, Thumbs.db).

Live Interactive Example

Hit Run Code to see it live

Configure .gitignore and .gitattributes

Git 2.45 / CLI

Output Console

Click "Run Code" to view the rendered output.

How it works: .gitignore and .gitattributes establish project governance rules for all contributors.

Your Turn: Micro Challenge

No pressure! Edit the starter code below and test your solution with instant feedback.

Micro Exercise

Create .gitignore Configuration

Create a .gitignore file ignoring "*.tmp" and ".env".
Stage and commit with message "chore: configure .gitignore".

Sandbox Output

Click "Run & Check" to test your solution.

Finished reading and practicing?

Mark this lesson as completed to update your course progress.