Setup (Once & Done)
Essential | Estimated time: 30–45 minutes
এই সেকশন শেষ করলে তোমার machine Git-ready এবং GitHub-connected হয়ে যাবে। একবার করলেই হবে — বারবার করতে হবে না।
What You’ll Set Up
- Git install করবে তোমার OS-এ
- Git-কে তোমার পরিচয় দেবে (name + email)
- GitHub account বানাবে
- SSH key দিয়ে GitHub-এর সাথে secure connection করবে
- VS Code-এ Git integration দেখবে
Step 1: Install Git
Windows
Download
যাও https://git-scm.com/download/win
Install
Installer download করো এবং run করো
Configure Options
Installation-এর সময় এই options রাখো:
- Default editor: Visual Studio Code
- Branch name:
main(recommended) - বাকি সব default রাখো
Verify Installation
গিট সঠিকভাবে ইনস্টল হয়েছে কিনা যাচাই করে নাও।
git --versionOutput আসবে এরকম:
git version 2.43.0Pro Tip: Version যেকোনো 2.x হলেই চলবে। Exact number নিয়ে চিন্তা নেই।
Step 2: Git Identity
Git প্রতিটা commit-এ তোমার নাম আর email যোগ করে। এটা globally set করতে হবে — মানে তোমার সব project-এ একবারেই কাজ করবে।
git config --global user.name "Your Name"
git config --global user.email "you@example.com"Important: Email টা সেটাই দাও যেটা দিয়ে GitHub account বানাবে। না হলে তোমার commits GitHub profile-এ link হবে না।
Set Branch Name
ডিফল্ট ব্রাঞ্চের নাম ‘main’ হিসেবে সেট করার নিয়ম।
git config --global init.defaultBranch mainVerify Config
তোমার কনফিগারেশনগুলো সঠিকভাবে সেভ হয়েছে কিনা দেখে নাও।
git config --listOutput-এ দেখবে:
user.name=Your Name
user.email=you@example.com
init.defaultBranch=mainStep 3: GitHub Account
Visit GitHub
Sign Up
Sign up করো — username, email, password দাও
Verify
Email verify করো
Select Plan
Free plan select করো
Username Tips:
- Lowercase এবং hyphen ব্যবহার করো (
your-name) - Professional রাখো — এটা তোমার public identity
- পরে change করা যায় কিন্তু ঝামেলা হয়
Step 4: SSH Key
SSH key হলো তোমার digital identity card। এটা দিয়ে GitHub বুঝবে যে তুমিই push করছ — password ছাড়াই।
Generate Key
তোমার লোকাল মেশিনের জন্য একটি নতুন SSH কী তৈরি করো।
ssh-keygen -t ed25519 -C "you@example.com"Terminal জিজ্ঞেস করবে Enter file in which to save the key, শুধু Enter চাপো (default location ঠিকঠাক আছে)। এরপর Passphrase দিতে পারো (extra security) অথবা Enter চেপে skip করো।
Add to Agent
তৈরি করা কী-টি তোমার সিস্টেমের SSH এজেন্টে যুক্ত করো।
macOS / Linux
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519Copy Public Key
গিটহাবের সাথে কানেক্ট করার জন্য পাবলিক কী-টি কপি করে নাও।
macOS
pbcopy < ~/.ssh/id_ed25519.pubAdd to GitHub
কপি করা কী-টি তোমার গিটহাব অ্যাকাউন্টের সেটিংসে যুক্ত করো।
- GitHub-এ যাও → Settings → SSH and GPG keys
- New SSH key click করো
- Title দাও (যেমন:
My Laptop) - Key paste করো
- Add SSH key click করো
Test Connection
সবকিছু ঠিকঠাক সেটআপ হয়েছে কিনা পরীক্ষা করে দেখো।
ssh -T git@github.comপ্রথমবার The authenticity of host... আসলে yes লিখে Enter চাপো।
তারপর Hi your-username! You've successfully authenticated... দেখালে বুঝবে SSH connection সফল!
Step 5: VS Code
VS Code-এ Git already built-in আছে। কিছু extensions install করলে কাজ আরও সহজ হবে।
Extensions
ভিএস কোড-এ কাজের গতি বাড়াতে কিছু দরকারি এক্সটেনশন।
| Extension | কাজ |
|---|---|
| GitLens | Blame view, history, powerful Git UI |
| Git Graph | Visual branch tree দেখা |
| GitHub Pull Requests | VS Code থেকেই PR manage করা |
Install Extensions
এই এক্সটেনশনগুলো ভিএস কোড-এ ইনস্টল করার নিয়ম।
VS Code খোলো → Ctrl+Shift+X (Extensions panel) → নাম লিখে search করো → Install।
Ctrl+` চাপলে integrated terminal খুলবে। এখান থেকেই সব Git commands run করবে।
Common Problems & Fixes
Problem: ssh -T কাজ করছে না
# Debug mode-এ try করো
ssh -vT git@github.comসাধারণত কারণ: key সঠিকভাবে agent-এ add হয়নি। Fix: Step 4.2 আবার করো।
Problem: Commits-এ নাম দেখাচ্ছে না
Config-এর email আর GitHub-এর email match করছে না। Fix:
git config --global user.email "github-এ-যে-email-দিয়েছ"Problem: Windows-এ pbcopy কাজ করছে না
Windows-এ pbcopy নেই। clip use করো:
cat ~/.ssh/id_ed25519.pub | clipWhat’s Next?
Setup শেষ! এখন Git-এর আসল কাজ শুরু হবে।
→ The Core Loop
তুমি এখন সেই ৫টা command শিখবে যেগুলো ছাড়া Git-এ এক কদমও এগোনো যায় না।