Cách Sử Dụng GitHub Để Lưu Trữ Dự Án Đầu Tiên

Bạn vừa hoàn thành dự án lập trình đầu tiên. Có thể đó là một máy tính, ứng dụng to-do, hoặc website cá nhân. Giờ thì sao? Làm thế nào để lưu trữ nó đúng cách, chia sẻ với người khác, hoặc đảm bảo không bao giờ bị mất code?

Câu trả lời là GitHub — nền tảng nơi hơn 100 triệu lập trình viên lưu trữ, chia sẻ và cộng tác code. Dù bạn đang xây dựng portfolio, nộp đơn xin việc, hay chỉ đang học, biết cách sử dụng GitHub là một kỹ năng thiết yếu.

Hướng dẫn này sẽ đưa bạn qua mọi thứ từ đầu. Không cần kinh nghiệm Git hay GitHub trước đó.

Bạn Sẽ Học Được:
✅ Git và GitHub là gì và tại sao chúng quan trọng
✅ Cách cài đặt và cấu hình Git trên máy tính
✅ Cách tạo repository GitHub đầu tiên
✅ Cách đẩy code dự án lên GitHub
✅ Cách thực hiện thay đổi và theo dõi lịch sử dự án
✅ Các phương pháp tốt nhất để tổ chức repository

Git Là Gì? GitHub Là Gì?

Trước khi bắt đầu, hãy làm rõ hai thuật ngữ mà người mới thường nhầm lẫn:

Hãy nghĩ đơn giản thế này:

• Git giống như hệ thống "Lưu" và "Hoàn tác" cho toàn bộ dự án — nhưng mạnh hơn nhiều
• GitHub giống như Google Drive dành cho code — lưu trữ dự án online để bạn truy cập từ bất kỳ đâu

Tại Sao Bạn Nên Sử Dụng Git và GitHub?

1. Không bao giờ mất code nữa

Laptop có thể hỏng, ổ cứng có thể lỗi. Với GitHub, code của bạn được lưu trữ an toàn trên đám mây.

2. Theo dõi mọi thay đổi

Git ghi nhớ mọi thay đổi. Mắc lỗi? Bạn có thể quay lại bất kỳ phiên bản trước đó của code.

3. Xây dựng portfolio lập trình viên

Nhà tuyển dụng xem hồ sơ GitHub. Các repository của bạn cho thấy bạn có thể xây dựng được gì.

4. Cộng tác với người khác

Làm dự án nhóm? GitHub giúp nhiều người dễ dàng làm việc trên cùng một codebase.

5. Đó là tiêu chuẩn ngành

Hầu hết mọi công ty phần mềm đều sử dụng Git. Học ngay bây giờ giúp bạn có lợi thế trong sự nghiệp.

Bước 1: Cài Đặt Git

Trên macOS

Mở Terminal và chạy:

# Kiểm tra Git đã được cài chưa
git --version
 
# Nếu chưa, cài qua Homebrew
brew install git

Nếu bạn chưa có Homebrew, cài đặt nó trước từ brew.sh.

Trên Windows

Tải Git từ git-scm.com và chạy trình cài đặt. Sử dụng cài đặt mặc định — chúng hoạt động tốt cho người mới.

Sau khi cài đặt, mở Git Bash (đi kèm trình cài đặt) và xác minh:

git --version
# Output: git version 2.x.x

Trên Linux (Ubuntu/Debian)

sudo apt update
sudo apt install git
 
git --version

Bước 2: Cấu Hình Git

Sau khi cài đặt Git, cho nó biết bạn là ai. Thông tin này xuất hiện trong lịch sử commit:

git config --global user.name "Tên Của Bạn"
git config --global user.email "[email protected]"

Sử dụng cùng email bạn sẽ dùng cho tài khoản GitHub. Điều này liên kết commit local với hồ sơ GitHub.

Xác minh cấu hình:

git config --global --list
# Output:
# user.name=Tên Của Bạn
# [email protected]

Bước 3: Tạo Tài Khoản GitHub

1. Truy cập github.com
2. Click Sign up
3. Chọn username (đây sẽ là URL hồ sơ công khai: github.com/username-cua-ban)
4. Sử dụng username chuyên nghiệp — nhà tuyển dụng sẽ thấy điều này

Mẹo: Chọn username dễ nhớ và chuyên nghiệp. Tránh số ngẫu nhiên hoặc tên đùa. Ví dụ như chanh-le hoặc john-doe-dev là được.

Bước 4: Tạo Repository Đầu Tiên

Repository (hay "repo") giống như một thư mục cho dự án của bạn trên GitHub. Hãy tạo một cái.

Cách A: Tạo Trên GitHub Trước (Khuyến Nghị Cho Người Mới)

1. Click biểu tượng + ở góc trên bên phải GitHub
2. Chọn New repository
3. Điền thông tin:

4. Click Create repository

Hiểu Về .gitignore

File .gitignore cho Git biết file nào không cần theo dõi. Bạn không muốn upload:

• Dependencies (node_modules/, venv/)
• File build (dist/, build/)
• Thông tin bí mật (.env, API keys)
• File hệ điều hành (.DS_Store, Thumbs.db)

GitHub cung cấp template cho các ngôn ngữ phổ biến. Đây là ví dụ đơn giản:

# Dependencies
node_modules/
venv/
__pycache__/
 
# Biến môi trường (KHÔNG BAO GIỜ commit những file này!)
.env
.env.local
 
# Output build
dist/
build/
 
# File hệ điều hành
.DS_Store
Thumbs.db
 
# File IDE
.vscode/
.idea/

Bước 5: Kết Nối Dự Án Local Với GitHub

Bây giờ hãy kết nối dự án trên máy tính với repository GitHub.

Nếu Bạn Đã Có Thư Mục Dự Án

Điều hướng đến thư mục dự án trong terminal:

cd ~/my-projects/my-first-website

Khởi tạo Git trong dự án:

# Biến thư mục này thành Git repository
git init

Kết nối với repository GitHub:

# Thêm URL repository remote
git remote add origin https://github.com/username-cua-ban/my-first-website.git

Nếu Bạn Tạo Repo Trên GitHub Trước

Clone (tải về) repository về máy tính:

# Clone repository
git clone https://github.com/username-cua-ban/my-first-website.git
 
# Điều hướng vào thư mục dự án
cd my-first-website

Lệnh này tạo thư mục cùng tên repository và thiết lập kết nối Git tự động.

Bước 6: Quy Trình Git — Add, Commit, Push

Đây là quy trình cốt lõi bạn sẽ sử dụng hàng ngày. Hãy nghĩ đơn giản là ba bước:

Bước 6.1: Kiểm Tra Trạng Thái

Luôn bắt đầu bằng việc kiểm tra những gì đã thay đổi:

git status

Output ví dụ:

On branch main
Untracked files:
  (use "git add <file>..." to include in what will be committed)
        index.html
        style.css
        script.js

Bước 6.2: Stage File (git add)

Staging cho Git biết file nào bạn muốn đưa vào lần lưu tiếp theo:

# Thêm file cụ thể
git add index.html style.css
 
# Hoặc thêm TẤT CẢ file đã thay đổi
git add .

git add . thêm mọi thứ trong thư mục hiện tại. Hãy cẩn thận — đảm bảo bạn có file .gitignore trước để không vô tình thêm những file không nên.

Bước 6.3: Commit Thay Đổi (git commit)

Một commit là ảnh chụp dự án tại một thời điểm cụ thể. Luôn kèm theo message mô tả:

git commit -m "Add homepage with navigation bar and hero section"

Viết Commit Message Tốt:

Mẹo viết commit message:

• Bắt đầu bằng động từ: Add, Fix, Update, Remove, Refactor
• Giữ dưới 72 ký tự
• Mô tả cái gì và tại sao, không phải như thế nào

Bước 6.4: Push Lên GitHub (git push)

Push upload commit lên GitHub:

# Lần đầu push lên repository mới
git push -u origin main
 
# Sau lần đầu, chỉ cần
git push

Flag -u thiết lập remote branch mặc định, nên các lần push sau chỉ cần git push.

Quy Trình Hoàn Chỉnh

Đây là toàn bộ quy trình từ đầu đến cuối:

# 1. Thay đổi file (chỉnh sửa code, thêm file, v.v.)
 
# 2. Kiểm tra thay đổi
git status
 
# 3. Stage thay đổi
git add .
 
# 4. Commit với message
git commit -m "Add contact form with email validation"
 
# 5. Push lên GitHub
git push

Vậy thôi! Năm lệnh này chiếm 90% những gì bạn sẽ sử dụng hàng ngày.

Bước 7: Thực Hiện Thay Đổi và Theo Dõi Lịch Sử

Thực Hiện Thêm Thay Đổi

Sau lần push đầu tiên, quy trình vẫn giống nhau. Mỗi khi bạn thay đổi:

# Chỉnh sửa file...
git add .
git commit -m "Style the footer with flexbox layout"
git push

Xem Lịch Sử Commit

Xem tất cả commit trước đó:

git log --oneline

Output:

a1b2c3d Style the footer with flexbox layout
e4f5g6h Add contact form with email validation
i7j8k9l Add homepage with navigation bar and hero section
m0n1o2p Initial commit

Mỗi commit có ID duy nhất (như a1b2c3d) mà bạn có thể dùng để quay lại phiên bản đó nếu cần.

Xem Thay Đổi Trước Khi Commit

Xem những gì bạn đã thay đổi trước khi staging:

# Xem tất cả thay đổi chưa stage
git diff
 
# Xem thay đổi đã stage (sẵn sàng commit)
git diff --staged

Bước 8: Viết README Chất Lượng

README.md là thứ đầu tiên mọi người thấy khi truy cập repository. Một README tốt làm dự án trông chuyên nghiệp.

Đây là template:

# Tên Dự Án
 
Mô tả ngắn về dự án này làm gì.
 
## Demo
 
[Xem Demo](https://link-demo.com) (nếu có)
 
## Ảnh Chụp Màn Hình
 
![Screenshot](screenshot.png)
 
## Công Nghệ Sử Dụng
 
- HTML5
- CSS3
- JavaScript
 
## Bắt Đầu
 
### Yêu Cầu
 
- Trình duyệt web
- Git đã cài trên máy
 
### Cài Đặt
 
1. Clone repository:
   ```bash
   git clone https://github.com/username-cua-ban/ten-du-an.git

2. Mở index.html trong trình duyệt

Tôi Đã Học Được Gì

• Cách cấu trúc trang HTML semantic
• CSS Flexbox và Grid layout
• Thao tác DOM với JavaScript

Tác Giả

Tên Bạn - GitHub

 
## Lỗi Phổ Biến và Cách Sửa
 
### Lỗi 1: "Tôi đã commit thứ không nên commit"
 
Nếu bạn vô tình commit file (như `.env`):
 
```bash
# Xóa file khỏi Git tracking (giữ file local)
git rm --cached .env
 
# Thêm vào .gitignore
echo ".env" >> .gitignore
 
# Commit bản sửa
git add .gitignore
git commit -m "Remove .env from tracking and add to gitignore"
git push

Cảnh báo: Nếu bạn đã push thông tin bí mật (API keys, mật khẩu) lên repo public, hãy coi những thông tin đó đã bị lộ. Thay đổi chúng ngay lập tức, dù đã xóa file.

Lỗi 2: "Tôi viết sai commit message"

# Sửa commit message gần nhất (chỉ khi CHƯA push)
git commit --amend -m "Commit message đã sửa"

Lỗi 3: "Tôi muốn hoàn tác thay đổi"

# Hoàn tác thay đổi file cụ thể (trước khi staging)
git checkout -- filename.html
 
# Unstage file (sau git add, trước commit)
git reset HEAD filename.html

Lỗi 4: "Push bị từ chối"

Điều này thường xảy ra khi remote có thay đổi bạn chưa có ở local:

# Pull thay đổi remote trước, rồi push
git pull origin main
git push

Thiết Lập Xác Thực SSH (Tùy Chọn Nhưng Khuyến Nghị)

Mệt mỏi với việc nhập username và password mỗi lần push? Thiết lập SSH:

# 1. Tạo SSH key
ssh-keygen -t ed25519 -C "[email protected]"
 
# 2. Nhấn Enter cho vị trí mặc định, rồi đặt passphrase (hoặc để trống)
 
# 3. Copy public key
# Trên macOS:
cat ~/.ssh/id_ed25519.pub | pbcopy
 
# Trên Linux:
cat ~/.ssh/id_ed25519.pub
# (copy output thủ công)
 
# Trên Windows (Git Bash):
cat ~/.ssh/id_ed25519.pub | clip

Sau đó thêm key vào GitHub:

1. Vào Settings → SSH and GPG keys → New SSH key
2. Dán public key
3. Click Add SSH key

Bây giờ dùng SSH URL thay vì HTTPS:

# Đổi remote URL sang SSH
git remote set-url origin [email protected]:username-cua-ban/my-first-website.git

Bảng Tóm Tắt Lệnh Git

Đây là tham khảo nhanh cho các lệnh bạn sẽ dùng nhiều nhất:

Mẹo Tổ Chức GitHub Profile

1. Đặt Tên Repository Rõ Ràng

2. Sử Dụng Quy Ước Đặt Tên Nhất Quán

Chọn một kiểu và giữ nguyên:

• kebab-case: my-first-project (phổ biến nhất trên GitHub)
• snake_case: my_first_project

3. Ghim Repository Tốt Nhất

Trên hồ sơ GitHub, bạn có thể ghim tối đa 6 repository. Chọn những công việc tốt nhất để trưng bày.

4. Commit Thường Xuyên

Đừng đợi đến khi hoàn thành toàn bộ dự án. Commit những thay đổi nhỏ, có ý nghĩa trong quá trình làm việc:

# Buổi sáng: Bắt đầu header
git add .
git commit -m "Add header with logo and navigation links"
 
# Buổi chiều: Style header
git add .
git commit -m "Style header with responsive flexbox layout"
 
# Buổi tối: Thêm hero section
git add .
git commit -m "Add hero section with background image"

Điều này tạo lịch sử chi tiết cho thấy tiến trình và cách tư duy của bạn.

Tiếp Theo Là Gì?

Khi đã thoải mái với những điều cơ bản, hãy khám phá các chủ đề này:

1. Branching — Làm việc trên tính năng mà không ảnh hưởng code chính
2. Pull Requests — Đề xuất thay đổi và nhận code review
3. GitHub Issues — Theo dõi bug và yêu cầu tính năng
4. GitHub Actions — Tự động hóa testing và deployment
5. Forking — Đóng góp vào dự án mã nguồn mở của người khác

Tổng Kết

Đây là những gì chúng ta đã đi qua:

Điểm chính cần nhớ: Git và GitHub không phức tạp khi bạn hiểu quy trình cơ bản. Bắt đầu với git add, git commit, và git push — đó là tất cả những gì bạn cần cho dự án đầu tiên. Mọi thứ khác bạn có thể học dần.

Bạn trong tương lai (và nhà tuyển dụng tương lai) sẽ cảm ơn bạn vì bắt đầu sử dụng GitHub từ hôm nay.

Tài Liệu Tham Khảo

• Tài Liệu Chính Thức Git
• GitHub Docs — Bắt Đầu
• GitHub Skills — Khóa Học Tương Tác
• Sách Pro Git (Miễn Phí)
• Git Cheat Sheet của GitHub