.gitignore, .gitattributes আর git config — কী track করবেন, কীভাবে

১ · কী track করবেন, কী করবেন না

একটি কাল্পনিক অনলাইন বাজার অ্যাপের দলে নতুন যোগ দিয়েছেন রহিম। প্রথম দিনেই তিনি project folder-এ git add . দিয়ে সব কিছু commit করে push করলেন। বিকেলে দলের lead জানালেন তিনটি সমস্যা: repository-তে হাজার হাজার file-এর node_modules/ folder ঢুকেছে, প্রতিটি build-এর পর dist/ folder-এর বদল নিয়ে অর্থহীন diff আসছে, আর সবচেয়ে খারাপ — database-এর password লেখা .env file-টিও এখন সবাই দেখতে পাচ্ছেন।

রহিমের ভুলটা খুব সাধারণ। পর্ব ৮-এ দেখেছেন, git add একটি file-কে working tree থেকে staging area-য় তোলে, আর commit সেটিকে repository-র স্থায়ী ইতিহাসে লিখে দেয়। কিন্তু কোন file আদৌ ইতিহাসে থাকার যোগ্য, সেই সিদ্ধান্ত Git নেয় না — নিতে হয় আপনাকে।

কিছু জায়গায় দলভেদে মত আলাদা। কিছু Go বা PHP দল ইচ্ছে করেই vendor/ folder commit করে, যাতে internet ছাড়াও build হয়। কিছু দল .vscode/extensions.json-এর মতো সবার কাজের একটি-দুটি file রাখে, বাকি .vscode/ বাদ দেয়। নিয়ম মুখস্থ করার চেয়ে প্রশ্নটা মনে রাখুন: “এই file কি মানুষ লেখেন, নাকি যন্ত্র বানায়? এটি কি সবার জন্য, নাকি শুধু আমার?”

২ · .gitignore-এর ভাষা — pattern-এর নিয়ম

.gitignore একটি সাধারণ text file, সাধারণত project-এর root-এ থাকে আর বাকি কোডের মতোই commit করা হয় — যাতে দলের সবাই একই তালিকা পান। এর প্রতিটি লাইন একটি glob pattern. নিয়মগুলো Git-এর অফিসিয়াল gitignore documentation অনুযায়ী (git help gitignore):

• খালি লাইন কিছুই মেলায় না — শুধু পড়ার সুবিধার জন্য ফাঁক। # দিয়ে শুরু লাইন মন্তব্য। নামের শুরুতেই সত্যিকারের # থাকলে লিখুন \#. লাইনের শেষের ফাঁকা জায়গা বাদ পড়ে, যদি না \ দিয়ে আটকানো হয়।
• ! দিয়ে শুরু হলে pattern উল্টে যায়: আগে বাদ পড়া file আবার ফেরে (negation). নামের শুরুতে সত্যিকারের ! থাকলে \!.
• শেষে / থাকলে pattern শুধু folder মেলায়। logs/ মেলে logs নামের folder-এ, কিন্তু logs নামের সাধারণ file-এ নয়।
• শুরুতে বা মাঝে / থাকলে pattern .gitignore file-টি যে folder-এ আছে, সেখান থেকে গোনা হয় (anchored). /dist/ শুধু root-এর dist; docs/*.pdf শুধু root-এর docs-এর ভেতরে। কোনো / না থাকলে (বা শুধু শেষে থাকলে) pattern যেকোনো গভীরতায় মেলে: *.log মেলে debug.log আর a/b/c.log দুটোতেই।
• * মানে / ছাড়া যেকোনো কিছু (শূন্য বা বেশি অক্ষর); ? মানে / ছাড়া ঠিক একটি অক্ষর; [a-z] মানে বন্ধনীর পরিসরের একটি অক্ষর।
• ** তিন রূপে বিশেষ: শুরুতে **/foo মানে যেকোনো folder-এর ভেতরের foo; শেষে abc/** মানে abc-এর ভেতরের সব কিছু, যত গভীরেই হোক; মাঝে a/**/b মানে a/b, a/x/b, a/x/y/b — শূন্য বা বেশি folder. অন্য জায়গায় পরপর দুটি তারা সাধারণ *-এর মতো আচরণ করে।

এবার সবচেয়ে গুরুত্বপূর্ণ নিয়ম: একই file-এর ভেতরে লাইনগুলো ওপর থেকে নিচে পড়া হয়, আর যে শেষ লাইনটি path-এ মেলে, সিদ্ধান্ত তার। তার আগে একটি পরীক্ষা: path-এর কোনো parent folder কি বাদ পড়েছে? পড়লে Git সেই folder-এর ভেতরে ঢোকেই না। নিচের stepper-এ চারটি লাইনের একটি তালিকায় তিনটি path যাচাই করা হচ্ছে।

৩ · Negation-এর ফাঁদ আর কোন তালিকা জেতে

Negation দেখতে সহজ, কিন্তু Git-এর documentation-এ একটি বাক্য সবচেয়ে বেশি ভুল বোঝা হয়: কোনো file-এর parent folder বাদ পড়লে সেই file আর ফেরানো যায় না। কারণ performance: বাদ পড়া folder-এর ভেতরে Git ঢোকেই না, তাই ভেতরের file-এর ওপর কোন ! লাইন আছে, সেটা দেখার সুযোগই আসে না।

আরও গভীরের একটি file ফেরাতে প্রতিটি স্তর খুলতে হয়। শুধু a/b/c.txt রাখতে চাইলে: a/*, !a/b/, a/b/*, !a/b/c.txt — চার লাইন। Git ২.৫৩-এ চালিয়ে দেখা গেছে, এতে a/b/c.txt থাকে, a/b/d.txt আর a/e.txt বাদ পড়ে।

একই নিয়ম নিজে বানিয়ে দেখুন

নিচের JavaScript-এ একটি ছোট matcher আছে: প্রতিটি লাইনকে regular expression-এ বদলে, আগে parent folder আর পরে file যাচাই করে, শেষ মেলা লাইনকে কারণ হিসেবে দেখায়। এটি একটি সরলীকৃত মডেল — একটিমাত্র root .gitignore ধরে নেয়, \-escape, ভেতরের folder-এর আলাদা .gitignore বা বড়-ছোট হাতের অক্ষরের নিয়ম (core.ignorecase) বোঝে না। তবু এই ১৬টি path-এ এর ফল আসল git check-ignore -v -n-এর সাথে হুবহু মিলেছে (Git ২.৫৩)।

// A SIMPLIFIED .gitignore matcher: one .gitignore at the root, no escapes.
// Blank and # lines skipped; "!" re-includes; trailing "/" = directories only;
// a "/" at the start or middle anchors to the root; *, ?, [..], ** as in gitignore.
const text = "# build output\ndist/\n*.log\n!important.log\n/config.local.json\n" +
  "docs/**/*.pdf\ntemp?.txt\nbuild[0-9].zip\nsecret/\n!secret/readme.md\nprivate/*\n!private/readme.md";
const G = { "/**/": "/(?:.*/)?", "**/": "(?:.*/)?", "/**": "/.*", "**": ".*", "*": "[^/]*", "?": "[^/]" };
const rules = text.split("\n").map((line, i) => ({ line, no: i + 1 }))
  .filter(r => r.line.trim() !== "" && !r.line.startsWith("#")).map(r => {
    let p = r.line; const neg = p.startsWith("!"); if (neg) p = p.slice(1);
    const dirOnly = p.endsWith("/"); if (dirOnly) p = p.slice(0, -1);
    const anchored = p.includes("/"); if (p.startsWith("/")) p = p.slice(1);
    const body = p.replace(/[.+^${}()|\\]/g, "\\$&").replace(/\/\*\*\/|\*\*\/|\/\*\*|\*\*|\*|\?/g, t => G[t]);
    return { ...r, neg, dirOnly, rx: new RegExp("^" + (anchored ? "" : "(?:.*/)?") + body + "$") };
  });
const lastMatch = (path, isDir) => {          // the LAST matching line decides
  let hit = null;
  for (const r of rules) if ((!r.dirOnly || isDir) && r.rx.test(path)) hit = r;
  return hit;
};
function check(file) {
  const parts = file.split("/"), f = file.padEnd(24);
  for (let i = 1; i < parts.length; i++) {      // parent directories first
    const dir = parts.slice(0, i).join("/"), h = lastMatch(dir, true);
    if (h && !h.neg) return `IGNORED ${f} parent ${dir}/ excluded by line ${h.no}: ${h.line}`;
  }
  const h = lastMatch(file, false);
  if (!h) return `kept    ${f} no pattern matches`;
  return `${h.neg ? "kept   " : "IGNORED"} ${f} line ${h.no}: ${h.line}`;
}
["dist/app.js", "src/dist/x.js", "debug.log", "logs/important.log", "config.local.json",
 "src/config.local.json", "docs/manual.pdf", "docs/guide/v1/manual.pdf", "temp1.txt",
 "temp10.txt", "build7.zip", "buildA.zip", "secret/readme.md", "private/readme.md",
 "private/key.pem", "src/app.js"].forEach(p => console.log(check(p)));

IGNORED dist/app.js              parent dist/ excluded by line 2: dist/
IGNORED src/dist/x.js            parent src/dist/ excluded by line 2: dist/
IGNORED debug.log                line 3: *.log
kept    logs/important.log       line 4: !important.log
IGNORED config.local.json        line 5: /config.local.json
kept    src/config.local.json    no pattern matches
IGNORED docs/manual.pdf          line 6: docs/**/*.pdf
IGNORED docs/guide/v1/manual.pdf line 6: docs/**/*.pdf
IGNORED temp1.txt                line 7: temp?.txt
kept    temp10.txt               no pattern matches
IGNORED build7.zip               line 8: build[0-9].zip
kept    buildA.zip               no pattern matches
IGNORED secret/readme.md         parent secret/ excluded by line 9: secret/
kept    private/readme.md        line 12: !private/readme.md
IGNORED private/key.pem          line 11: private/*
kept    src/app.js               no pattern matches

কোন তালিকা জেতে — ignore-এর চারটি উৎস

Ignore-এর pattern শুধু একটি file থেকে আসে না। Git চারটি উৎস দেখে; ওপরের উৎস নিচেরটিকে ছাপিয়ে যায়, আর একই উৎসের ভেতরে শেষ মেলা লাইন জেতে:

1. Command line-এ দেওয়া pattern — যেসব command এমন option নেয় (যেমন git ls-files --exclude).
2. .gitignore file-গুলো — path-এর নিজের folder বা যেকোনো ওপরের folder-এর। কাছের (গভীরতর) folder-এর .gitignore ওপরের folder-এরটাকে ছাপিয়ে যায়। Root-এ *.csv আর data/.gitignore-এ !keep.csv থাকলে data/keep.csv থাকে, কিন্তু data/other.csv আর root-এর keep.csv বাদ — Git ২.৫৩-এ যাচাই করা।
3. .git/info/exclude — শুধু এই clone-এর জন্য, commit হয় না। নিজের পরীক্ষার file লুকাতে ভালো।
4. core.excludesFile — আপনার সব repository-র জন্য একটি ব্যক্তিগত তালিকা। Set না করলে Git দেখে ~/.config/git/ignore (বা $XDG_CONFIG_HOME/git/ignore). .DS_Store, Thumbs.db, editor-এর swap file এখানেই রাখার জায়গা।

$ git config --global core.excludesFile ~/.gitignore_global
$ printf '.DS_Store\nThumbs.db\n*.swp\n' >> ~/.gitignore_global

৪ · Git-কেই জিজ্ঞেস করুন — status --ignored আর check-ignore

অনুমান না করে Git-কে জিজ্ঞেস করাই নিরাপদ। এবার রহিমের project-টি নতুন করে, ঠিকভাবে বানাই। এই পর্বের সব transcript Git ২.৫৩-এ একটি আলাদা scratch folder-এ সত্যিই চালিয়ে নেওয়া। লেখক Rahim, email rahim@example.com, আর প্রতিটি commit-এর তারিখ নির্দিষ্ট (১৫ জানুয়ারি ২০২৬, সকাল ১০টা থেকে এক মিনিট করে বাড়ানো) — তাই একই file দিয়ে চালালে commit hash-ও একই আসার কথা। নিজের আসল config যেন না বদলায়, সেজন্য GIT_CONFIG_SYSTEM আর GIT_CONFIG_GLOBAL environment variable দিয়ে system আর global config দুটি scratch file-এ সরানো হয়েছে (Git ২.৩২ থেকে এই দুটি variable আছে)। পরীক্ষার সময় আপনিও এই কৌশল ব্যবহার করতে পারেন।

শুরুতে রহিম ভুল করে .env-সহ প্রথম commit করেছেন — অংশ ৫-এ সেটা ঠিক করব:

$ export GIT_CONFIG_SYSTEM=../etc/gitconfig GIT_CONFIG_GLOBAL=../home/.gitconfig
$ git -c init.defaultBranch=main init -q bazar
$ cd bazar
$ git config user.name "Rahim"
$ git config user.email "rahim@example.com"
$ git config core.autocrlf false
$ export GIT_AUTHOR_DATE="2026-01-15T10:00:00+06:00" GIT_COMMITTER_DATE="2026-01-15T10:00:00+06:00"
$ git add package.json src/index.js .env
$ git commit -q -m "Add app skeleton"

এরপর project-এ এলো node_modules/express/index.js, dist/bundle.js, logs/app.log, debug.log, .vscode/settings.json, .DS_Store, খালি মানের .env.example — আর এই .gitignore:

# Dependencies
node_modules/

# Build output (only the top-level dist)
/dist/

# Logs
*.log
logs/

# Secrets: every .env file, except the example
.env*
!.env.example

# Editor and OS files
.vscode/
.DS_Store

$ git status
On branch main
Untracked files:
  (use "git add <file>..." to include in what will be committed)
	.env.example
	.gitignore

nothing added to commit but untracked files present (use "git add" to track)
$ git status --ignored
On branch main
Untracked files:
  (use "git add <file>..." to include in what will be committed)
	.env.example
	.gitignore

Ignored files:
  (use "git add -f <file>..." to include in what will be committed)
	.DS_Store
	.vscode/
	debug.log
	dist/
	logs/
	node_modules/

nothing added to commit but untracked files present (use "git add" to track)

সাধারণ git status-এ মাত্র দুটি untracked file — বাকি সব ignored, তাই চুপ। --ignored দিলে লুকানোগুলোও আলাদা তালিকায় আসে। খেয়াল করুন, Git পুরো folder দেখায় (node_modules/), ভেতরের প্রতিটি file নয় — বাদ পড়া folder-এ সে ঢোকে না। আর .env কোথাও নেই! কারণ এটি আগেই commit হয়েছে, এটি tracked; বদলায়নি বলে status-এ আসেনি। এবার প্রতিটি file-এর কারণ জানতে check-ignore:

$ git check-ignore -v debug.log dist/bundle.js node_modules/express/index.js .env.example src/index.js
.gitignore:8:*.log	debug.log
.gitignore:5:/dist/	dist/bundle.js
.gitignore:2:node_modules/	node_modules/express/index.js
.gitignore:13:!.env.example	.env.example
$ git check-ignore -v -n debug.log .env.example src/index.js
.gitignore:8:*.log	debug.log
.gitignore:13:!.env.example	.env.example
::	src/index.js
$ git check-ignore -v .env; echo $?
1
$ git check-ignore -v --no-index .env
.gitignore:12:.env*	.env

শূন্য থেকে লিখবেন না — template

প্রায় প্রতিটি ভাষা আর framework-এর জন্য তৈরি .gitignore পাওয়া যায়। সবচেয়ে পরিচিত সংগ্রহ GitHub-এর খোলা repository github/gitignore (Node, Python, Java, Unity…); GitHub-এ নতুন repository বানানোর সময় এখান থেকেই একটি template বেছে নেওয়ার সুযোগ থাকে (লেখার সময়ে; platform-ভেদে আলাদা)। Template শুরু হিসেবে চমৎকার, কিন্তু অন্ধভাবে নয় — প্রতিটি লাইন পড়ুন, নিজের project-এ না লাগলে মুছুন, আর git status --ignored দিয়ে দেখে নিন জরুরি কোনো file বাদ পড়ছে কি না।

৫ · আগেই commit হয়ে গেছে? git rm --cached

অংশ ৪-এ দেখলেন, tracked file-এর ওপর .gitignore-এর কোনো জোর নেই। Git-এর চোখে একটি file হয় tracked (index-এ আছে), নয়তো untracked; ignore-এর প্রশ্ন ওঠে শুধু untracked-এর বেলায়। তাই প্রথমে file-টিকে index থেকে সরাতে হবে, কিন্তু আপনার disk থেকে নয়। এই কাজটিই করে git rm --cached: “index থেকে মুছুন, working tree-তে রেখে দিন।”

$ git rm --cached .env
rm '.env'
$ git status
On branch main
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
	deleted:    .env

Untracked files:
  (use "git add <file>..." to include in what will be committed)
	.env.example
	.gitignore

$ ls .env
.env
$ git add .gitignore .env.example
$ git commit -m "Stop tracking .env; add .gitignore"
[main c0873ce] Stop tracking .env; add .gitignore
 3 files changed, 18 insertions(+), 1 deletion(-)
 delete mode 100644 .env
 create mode 100644 .env.example
 create mode 100644 .gitignore
$ git ls-files
.env.example
.gitignore
package.json
src/index.js
$ git log --oneline -- .env
c0873ce Stop tracking .env; add .gitignore
0f0db3c Add app skeleton
$ git check-ignore -v .env; echo $?
.gitignore:12:.env*	.env
0

পুরো folder ভুল করে commit হলে -r লাগে। নিচের stepper-এ একটি C project-এর build/ folder-এর ঘটনা (আলাদা scratch repository, Git ২.৫৩, সময় সকাল ১১টা):

৬ · .gitattributes — Git-কে file-এর স্বভাব জানানো

.gitignore বলে কোন file Git দেখবে না; .gitattributes বলে যেগুলো দেখবে, সেগুলোর সাথে কেমন আচরণ করবে। এটিও commit করা হয়, তাই দলের সবার কম্পিউটারে একই নিয়ম চলে — ব্যক্তিগত config-এর ওপর ভরসা করতে হয় না। প্রতিটি লাইনে একটি pattern, তারপর এক বা একাধিক attribute:

# Normalize every text file to LF in the repository and on checkout
* text=auto eol=lf
# Windows batch files must keep CRLF
*.bat   text eol=crlf
# Never touch these bytes
*.png   binary
*.jpg   binary
# Better hunk headers in diffs
*.py    diff=python
# Leave these out of "git archive" release tarballs
/tests/       export-ignore
.gitattributes export-ignore
# GitHub-only hints (Linguist): hide generated code in stats and diffs
dist/**  linguist-generated

• চার অবস্থা: attribute set (text), unset (-text), একটি মান (eol=lf), বা unspecified (কিছু বলা নেই — Git তখন config দেখে)। !text লিখলে আগের কোনো লাইনের দেওয়া মান মুছে unspecified করে।
• Pattern-এর নিয়ম প্রায় .gitignore-এর মতো, তবে দুটি পার্থক্য: ! দিয়ে negative pattern নিষিদ্ধ (Git ২.৫৩ লিখলে বলে warning: Negative patterns are ignored in git attributes), আর folder মেলানো pattern ভেতরের file-এ নিজে থেকে ছড়ায় না — তাই build/ নয়, লিখতে হয় build/**. একাধিক লাইন একই file-এ মিললে, প্রতিটি attribute-এর জন্য শেষ লাইনটি জেতে।
• text, text=auto, eol: line ending-এর নিয়ম, পরের অংশে বিস্তারিত। text=auto মানে Git নিজে ঠিক করবে file-টি text কি না।
• binary: একটি macro, যার মানে -diff -merge -text — লাইনভিত্তিক diff নয়, লাইনভিত্তিক merge নয়, line ending রূপান্তর নয়। নিচের transcript-এ git check-attr ঠিক এটাই দেখাবে।
• Diff driver: diff=python-এর মতো built-in নাম (python, java, cpp, html, markdown, rust ইত্যাদি) diff-এর প্রতিটি অংশের শিরোনামে ঠিক function বা class-এর নাম দেখায়। নিজের driver-ও বানানো যায়: *.docx diff=word লিখে config-এ diff.word.textconv-এ এমন একটি program দিলে, যা file থেকে text বের করে, Word file-এরও পড়ার মতো diff মেলে।
• export-ignore: git archive দিয়ে release-এর zip বা tarball বানানোর সময় এই path বাদ যায় (release নিয়ে পর্ব ১৮)।
• linguist-*: এগুলো Git-এর নয়, GitHub-এর Linguist library-র নিজস্ব নিয়ম — repository-র ভাষার পরিসংখ্যান আর pull request-এ generated file-এর diff লুকানো নিয়ন্ত্রণ করে (লেখার সময়ে; নাম আর আচরণ platform-ভেদে আলাদা)। Git নিজে অচেনা attribute উপেক্ষা করে।

বড় binary file (ভিডিও, design file) সামলাতে Git LFS-ও .gitattributes-এ filter=lfs diff=lfs merge=lfs -text লাইন লিখে কাজ করে; এর বিস্তারিত পর্ব ১৯-এ।

৭ · Line ending — CRLF বনাম LF

প্রতিটি text file-এ লাইনের শেষে একটি অদৃশ্য line ending থাকে। Windows-এর প্রচলিত রীতি দুটি byte: CRLF (\r\n, 0x0D 0x0A); Linux আর macOS-এর একটি: LF (\n, 0x0A). নাম দুটি এসেছে টাইপরাইটার আর teletype যুগ থেকে — “carriage return” মানে লেখার মাথা বাঁ দিকে ফেরানো, “line feed” মানে কাগজ এক লাইন ওপরে তোলা। পুরোনো Mac OS (OS X-এর আগে) আবার শুধু CR ব্যবহার করত।

Git-এর সমাধান: repository-র ভেতরে text file সবসময় LF রাখা (normalization), আর দরকার হলে শুধু working tree-তে OS-এর রীতিতে বদলানো। রূপান্তর হয় দুই জায়গায়: git add-এর সময় (working tree → index) আর checkout-এর সময় (index → working tree). কখন কী হবে, তা ঠিক করে core.autocrlf আর .gitattributes:

সমস্যা হলো, core.autocrlf প্রত্যেকের নিজের config — দলের দশজনের একজন ভুল setting রাখলেই repository-তে CRLF ঢুকে পড়ে। এজন্য স্থায়ী সমাধান .gitattributes, যা repository-র সাথেই চলে। কোনো path-এ text attribute বলা থাকলে কোন file normalize হবে, সেই সিদ্ধান্ত আর core.autocrlf-এর হাতে থাকে না: * text=auto থাকলে Git যে file-কে text বলে চেনে, সেটি repository-তে LF হয়ে ঢোকে, যার কম্পিউটারেই হোক। Checkout-এর line ending আলাদা করে বেঁধে দিতে eol=lf বা eol=crlf. Text কি না বুঝতে Git দেখে file-এ NUL byte (0x00), একা CR বা অস্বাভাবিক বেশি non-printable byte আছে কি না — থাকলে binary, তখন একটি byte-ও বদলায় না।

নিচের মডেলে চারটি file (Windows editor-এর CRLF, Linux editor-এর LF, দুটো মেশানো, আর একটি PNG-এর আসল শুরুর byte) চারটি setting-এ add আর checkout করা হচ্ছে। একই চারটি file দিয়ে Git ২.৫৩-এ git cat-file আর checkout চালিয়ে byte মেলানো হয়েছে — ফল হুবহু এক।

// Line-ending model: "add" = working tree -> index, "checkout" = index -> working tree.
// Text detection like Git's auto mode: a NUL byte or a lone CR means "binary".
const FILES = [
  ["notes.txt", "a\r\nb\r\n"],          // saved by a Windows editor (CRLF)
  ["app.js", "a\nb\n"],                 // saved by a Linux/macOS editor (LF)
  ["mixed.txt", "a\r\nb\n"],            // both kinds in one file
  ["logo.png", "\x89PNG\r\n\x1a\n\0\0"], // real PNG header bytes: contains CRLF and NUL
];
const isBinary = s => s.includes("\0") || /\r(?!\n)/.test(s);
const toLF = s => s.replace(/\r\n/g, "\n");
const toCRLF = s => s.replace(/\r?\n/g, "\r\n");
const show = s => [...s].map(c => c === "\r" ? "\\r" : c === "\n" ? "\\n" :
  c === "\0" ? "\\0" : c < " " || c > "~" ? "\\x" + c.charCodeAt(0).toString(16) : c).join("");
const MODES = {             // [what add does, what checkout does] for TEXT files
  "autocrlf=true":  [toLF, toCRLF],
  "autocrlf=input": [toLF, s => s],
  "autocrlf=false": [s => s, s => s],
  "attr text=auto eol=lf": [toLF, s => s],   // .gitattributes: same on every OS
};
for (const [mode, [onAdd, onCheckout]] of Object.entries(MODES)) {
  console.log(`== ${mode}`);
  for (const [name, work] of FILES) {
    const bin = isBinary(work);
    const index = bin ? work : onAdd(work);
    const back = bin ? index : onCheckout(index);
    console.log(`  ${name.padEnd(9)} ${bin ? "binary" : "text  "} index: ${show(index).padEnd(22)} checkout: ${show(back)}`);
  }
}

== autocrlf=true
  notes.txt text   index: a\nb\n                 checkout: a\r\nb\r\n
  app.js    text   index: a\nb\n                 checkout: a\r\nb\r\n
  mixed.txt text   index: a\nb\n                 checkout: a\r\nb\r\n
  logo.png  binary index: \x89PNG\r\n\x1a\n\0\0  checkout: \x89PNG\r\n\x1a\n\0\0
== autocrlf=input
  notes.txt text   index: a\nb\n                 checkout: a\nb\n
  app.js    text   index: a\nb\n                 checkout: a\nb\n
  mixed.txt text   index: a\nb\n                 checkout: a\nb\n
  logo.png  binary index: \x89PNG\r\n\x1a\n\0\0  checkout: \x89PNG\r\n\x1a\n\0\0
== autocrlf=false
  notes.txt text   index: a\r\nb\r\n             checkout: a\r\nb\r\n
  app.js    text   index: a\nb\n                 checkout: a\nb\n
  mixed.txt text   index: a\r\nb\n               checkout: a\r\nb\n
  logo.png  binary index: \x89PNG\r\n\x1a\n\0\0  checkout: \x89PNG\r\n\x1a\n\0\0
== attr text=auto eol=lf
  notes.txt text   index: a\nb\n                 checkout: a\nb\n
  app.js    text   index: a\nb\n                 checkout: a\nb\n
  mixed.txt text   index: a\nb\n                 checkout: a\nb\n
  logo.png  binary index: \x89PNG\r\n\x1a\n\0\0  checkout: \x89PNG\r\n\x1a\n\0\0

এবার রহিমের repository-তে আসল .gitattributes যোগ করি। notes.txt CRLF-এ লেখা, deploy.sh আর build.bat LF-এ, logo.png-এ PNG-এর byte:

$ cat .gitattributes
* text=auto eol=lf
*.bat text eol=crlf
*.png binary
$ git add .gitattributes notes.txt deploy.sh build.bat logo.png
warning: in the working copy of 'build.bat', LF will be replaced by CRLF the next time Git touches it
warning: in the working copy of 'notes.txt', CRLF will be replaced by LF the next time Git touches it
$ git ls-files --eol notes.txt deploy.sh build.bat logo.png
i/lf    w/lf    attr/text eol=crlf    	build.bat
i/lf    w/lf    attr/text=auto eol=lf 	deploy.sh
i/-text w/-text attr/-text            	logo.png
i/lf    w/crlf  attr/text=auto eol=lf 	notes.txt
$ git check-attr -a deploy.sh logo.png
deploy.sh: text: auto
deploy.sh: eol: lf
logo.png: binary: set
logo.png: diff: unset
logo.png: merge: unset
logo.png: text: unset
logo.png: eol: lf

৮ · git config-এর স্তর — কোন মান কোথা থেকে

পর্ব ৭-এ প্রথম setup-এর সময় git config --global user.name লিখেছিলেন। এই --global আসলে একটি স্তরের নাম। git config একই key একাধিক file-এ খোঁজে; প্রতিটি file একটি scope:

• system — কম্পিউটারের সব ব্যবহারকারীর জন্য। Linux-এ সাধারণত /etc/gitconfig; Git for Windows-এ Git-এর install folder-এর ভেতরের etc/gitconfig. লিখতে প্রায়ই admin অধিকার লাগে।
• global — আপনার নিজের, সব repository-র জন্য: ~/.gitconfig (বা ~/.config/git/config; দুটো থাকলে দুটোই পড়া হয়, ~/.gitconfig পরে)। নাম-email, editor, alias সাধারণত এখানে।
• local — শুধু এই repository: .git/config. Repository-র ভেতরে git config key value লিখলে, কোনো flag ছাড়া, এখানেই লেখা হয়। এটি commit হয় না।
• worktree — একই repository-র একাধিক working tree থাকলে (git worktree, পর্ব ৫৬) একটির জন্য আলাদা মান: .git/config.worktree, তবে আগে extensions.worktreeConfig চালু করতে হয়।
• git -c key=value command — শুধু সেই একবারের জন্য, কোনো file বদলায় না। এই পর্বের প্রথম transcript-এর git -c init.defaultBranch=main init ঠিক এটাই।

নিয়মটা একটাই: একটি মানের key-তে শেষে পড়া মান জেতে। কিছু key-তে একাধিক মান জমা হয় (যেমন remote.origin.fetch) — সেগুলো --get-all দিয়ে সব দেখা যায়। রহিমের repository-তে system file-এ core.autocrlf=true রাখা আছে (Windows installer যেমন রাখে), global-এ ব্যক্তিগত email, আর local-এ কাজের email ও core.autocrlf=false:

$ git config --list --show-origin
file:../etc/gitconfig	core.autocrlf=true
file:../etc/gitconfig	color.ui=auto
file:../home/.gitconfig	user.name=Rahim
file:../home/.gitconfig	user.email=rahim.home@example.com
file:../home/.gitconfig	init.defaultbranch=main
file:../home/.gitconfig	pull.rebase=true
file:.git/config	core.repositoryformatversion=0
file:.git/config	core.filemode=false
file:.git/config	core.bare=false
file:.git/config	core.logallrefupdates=true
file:.git/config	core.symlinks=false
file:.git/config	core.ignorecase=true
file:.git/config	core.autocrlf=false
file:.git/config	user.name=Rahim
file:.git/config	user.email=rahim@example.com
$ git config --show-origin --get user.email
file:.git/config	rahim@example.com
$ git config --show-scope --show-origin --get-all core.autocrlf
system	file:../etc/gitconfig	true
local	file:.git/config	false
$ git config get --show-origin core.autocrlf
file:.git/config	false

এবার একটি key ধাপে ধাপে মিলিয়ে দেখি — অফিসের project ~/work/shop-এ user.email কোথা থেকে আসে। Global config-এর শেষে একটি conditional include আছে, যার কথা অংশ ৯-এ:

একই নিয়ম একটি ছোট model-এ: প্রতিটি file ক্রমে পড়া, include এলে ঠিক সেখানে অন্য file ঢোকানো, আর শেষ মান জেতা। দুটি repository-র জন্য --list --show-origin আর কয়েকটি key-এর ফল:

// A model of how Git reads config: system file, then global, then local.
// Each file is read top to bottom and a LATER value of the same key wins.
// [includeIf "gitdir:~/work/"] splices another file in at exactly that spot.
const FILES = {
  "/etc/gitconfig": [["core.autocrlf", "true"], ["color.ui", "auto"]],
  "~/.gitconfig": [["user.name", "Rahim"], ["user.email", "rahim.home@example.com"],
    ["pull.rebase", "true"], ["includeif.gitdir:~/work/.path", "~/.gitconfig-work"]],
  "~/.gitconfig-work": [["user.email", "rahim@work.example.com"], ["pull.rebase", "false"]],
  "~/work/shop/.git/config": [["core.autocrlf", "false"]],
  "~/personal/blog/.git/config": [["color.ui", "always"]],
};
function read(file, gitdir, out) {
  for (const [key, val] of FILES[file] || []) {
    out.push({ key, val, origin: file });                 // --list shows the include line too
    const m = key.match(/^includeif\.gitdir:(.*)\.path$/);
    if (m && gitdir.startsWith(m[1])) read(val, gitdir, out); // pattern ending in "/" = prefix
  }
  return out;
}
function load(repo) {
  const out = [], gitdir = repo + "/.git/";
  for (const f of ["/etc/gitconfig", "~/.gitconfig", repo + "/.git/config"]) read(f, gitdir, out);
  return out;
}
for (const repo of ["~/work/shop", "~/personal/blog"]) {
  const all = load(repo);
  console.log(`== in ${repo}: git config --list --show-origin`);
  all.forEach(e => console.log(`file:${e.origin}\t${e.key}=${e.val}`));
  console.log(`-- git config --show-origin --get <key>, last value wins`);
  for (const k of ["user.email", "pull.rebase", "core.autocrlf", "color.ui"]) {
    const hits = all.filter(e => e.key === k), win = hits[hits.length - 1];
    console.log(`${k.padEnd(14)} file:${win.origin}\t${win.val}   (${hits.length} value(s) seen)`);
  }
}

== in ~/work/shop: git config --list --show-origin
file:/etc/gitconfig	core.autocrlf=true
file:/etc/gitconfig	color.ui=auto
file:~/.gitconfig	user.name=Rahim
file:~/.gitconfig	user.email=rahim.home@example.com
file:~/.gitconfig	pull.rebase=true
file:~/.gitconfig	includeif.gitdir:~/work/.path=~/.gitconfig-work
file:~/.gitconfig-work	user.email=rahim@work.example.com
file:~/.gitconfig-work	pull.rebase=false
file:~/work/shop/.git/config	core.autocrlf=false
-- git config --show-origin --get <key>, last value wins
user.email     file:~/.gitconfig-work	rahim@work.example.com   (2 value(s) seen)
pull.rebase    file:~/.gitconfig-work	false   (2 value(s) seen)
core.autocrlf  file:~/work/shop/.git/config	false   (2 value(s) seen)
color.ui       file:/etc/gitconfig	auto   (1 value(s) seen)
== in ~/personal/blog: git config --list --show-origin
file:/etc/gitconfig	core.autocrlf=true
file:/etc/gitconfig	color.ui=auto
file:~/.gitconfig	user.name=Rahim
file:~/.gitconfig	user.email=rahim.home@example.com
file:~/.gitconfig	pull.rebase=true
file:~/.gitconfig	includeif.gitdir:~/work/.path=~/.gitconfig-work
file:~/personal/blog/.git/config	color.ui=always
-- git config --show-origin --get <key>, last value wins
user.email     file:~/.gitconfig	rahim.home@example.com   (1 value(s) seen)
pull.rebase    file:~/.gitconfig	true   (1 value(s) seen)
core.autocrlf  file:/etc/gitconfig	true   (1 value(s) seen)
color.ui       file:~/personal/blog/.git/config	always   (2 value(s) seen)

৯ · কাজের setting, alias আর অফিস-ব্যক্তিগত আলাদা রাখা

নাম আর email-এর পরে কয়েকটি setting প্রায় সব পেশাদারের global config-এ দেখা যায়। প্রতিটির পূর্ণ অর্থ পরের পর্বগুলোতে আসবে; এখানে শুধু কী করে আর কেন:

Alias — লম্বা command-এর ডাকনাম

যে command প্রতিদিন দশবার লেখেন, তার জন্য একটি alias বানান। Alias config-এর [alias] section-এ থাকে; Git অচেনা command পেলে প্রথমে এখানে খোঁজে:

$ git config --global alias.lg "log --oneline --graph --all"
$ git lg
* 633c9bc Add .gitattributes and sample files
* c0873ce Stop tracking .env; add .gitignore
* 0f0db3c Add app skeleton
$ git config --get-regexp alias
alias.lg log --oneline --graph --all
$ cat ../home/.gitconfig
[user]
	name = Rahim
	email = rahim.home@example.com
[init]
	defaultBranch = main
[pull]
	rebase = true
[alias]
	lg = log --oneline --graph --all

অফিসের email অফিসের project-এ — includeIf

অনেকেই একই ল্যাপটপে অফিসের আর নিজের কাজ করেন। ভুল email-এ commit গেলে অফিসের ইতিহাসে ব্যক্তিগত ঠিকানা থেকে যায় (আর উল্টোটাও)। প্রতিটি repository-তে local email বসানো ভুলে যাওয়া সহজ; তার চেয়ে ভালো, folder দেখে নিজে থেকে বসানো:

[user]
	name = Rahim
	email = rahim.home@example.com
[pull]
	rebase = true
# must come AFTER [user]: a later value wins
[includeIf "gitdir:~/work/"]
	path = ~/.gitconfig-work

[user]
	email = rahim@work.example.com
[pull]
	rebase = false

Git ২.৫৩-এ এই দুটি file দিয়ে পরীক্ষা করা হয়েছে: ~/work/shop-এর ভেতরে git config --show-origin --get user.email দেখায় .gitconfig-work-এর পূর্ণ path আর rahim@work.example.com; ~/personal/blog-এ দেখায় ~/.gitconfig আর ব্যক্তিগত email. কয়েকটি খুঁটিনাটি: gitdir:-এর pattern / দিয়ে শেষ হলে Git নিজে শেষে ** যোগ করে, তাই ভেতরের সব গভীরতার repository মেলে; বড়-ছোট হাতের অক্ষর না মানতে gitdir/i:; branch-এর নাম দেখে শর্ত দিতে onbranch:; আর নতুন version-এ remote-এর URL দেখে hasconfig:remote.*.url:. শর্ত না মিললে Git কোনো error দেয় না — চুপচাপ বাদ দেয়, তাই --show-origin দিয়ে যাচাই করে নিন।

১০ · AI-এর যুগে — ignore আর config-এ AI-কে যাচাই

“আমার project-এর জন্য একটি .gitignore দাও” — AI কয়েক সেকেন্ডে লম্বা একটি তালিকা দেয়, আর বেশিরভাগ সময় সেটি কাজের। কিন্তু এই বিষয়ে AI-এর কিছু পরিচিত ভুল আছে, যার কয়েকটি সরাসরি নিরাপত্তার ঝুঁকি:

AI-এর দেওয়া .gitignore বা config হাতে পেলে — চেকলিস্ট

• নিজের কয়েকটি আসল path-এ git check-ignore -v -n চালিয়ে AI-এর দাবি মিলিয়েছি
• git status --ignored দেখে নিশ্চিত হয়েছি কোনো দরকারি source file বাদ পড়ছে না
• git ls-files দিয়ে দেখেছি, ignore করার কথা এমন কোনো file আগেই tracked কি না
• ইতিহাস বা remote বদলায় এমন command (reset --hard, push --force, filter) আগে একটি throwaway clone-এ চালিয়েছি
• অচেনা flag বা setting git help বা অফিসিয়াল documentation-এ খুঁজে পেয়েছি, আর Git-এর version মিলিয়েছি
• Prompt-এ কোনো আসল password, token বা private key দিইনি