วิธีตั้งค่า Git LFS บน macOS เพื่อจัดการไฟล์ขนาดใหญ่อย่างปลอดภัย

Overview — Overview

การใช้ Git LFS (Large File Storage) บน macOS ช่วยให้เราจัดเก็บไฟล์ขนาดใหญ่เช่น ภาพถ่าย, วิดีโอ หรือโมเดล 3D ได้โดยไม่ทำให้ repository มีขนาดบวมเกินไป การตั้งค่าถูกออกแบบให้ปลอดภัยและใช้งานง่าย

• Git LFS ทำงานเป็น extension ของ Git ที่อ้างอิงไฟล์ใหญ่ด้วย pointer
• เหมาะกับโครงการที่มีไฟล์ > 100 MB หรือจำนวนไฟล์มาก
• ลดเวลา clone / pull เนื่องจากดาวน์โหลดไฟล์จริงเฉพาะเมื่อจำเป็น

**Tip: อย่าเก็บไฟล์ใหญ่มากกว่า 2 GB ใน LFS เพราะหลายบริการโฮสต์ (GitHub, GitLab) มีขีดจำกัดที่ 2 GB ต่อไฟล์

สิ่งที่ต้องเตรียม — Prerequisites

ก่อนเริ่มติดตั้ง ควรตรวจสอบสภาพแวดล้อมของ macOS ให้พร้อม

• macOS 10.15 หรือใหม่กว่า (รองรับ Homebrew)
• มีการติดตั้ง Git อยู่แล้ว (`git --version` ตรวจสอบ)
• การเชื่อมต่ออินเทอร์เน็ตที่เสถียรเพื่อดาวน์โหลดแพ็กเกจ

ติดตั้ง Homebrew — Install Homebrew

Homebrew เป็น package manager ที่นิยมบน macOS ทำให้การติดตั้งซอฟต์แวร์เป็นเรื่องง่าย

• เปิด Terminal (`⌘ + Space` พิมพ์ “Terminal”)
• รันคำสั่งต่อไปนี้เพื่อติดตั้ง Homebrew

```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" ```

• ยืนยันการติดตั้งโดยตรวจสอบเวอร์ชัน

```bash brew --version ```

**ข้อควรระวัง: หากมีข้อความแจ้งให้เพิ่ม PATH ในไฟล์ `~/.zprofile` หรือ `~/.zshrc` ให้ทำตามเพื่อให้คำสั่ง `brew` ใช้ได้ทันที

ติดตั้ง Git LFS — Install Git LFS

ใช้ Homebrew เพื่อติดตั้ง Git LFS อย่างรวดเร็ว

• รันคำสั่งติดตั้ง

```bash brew install git-lfs ```

• หลังการติดตั้งให้ทำการ initialise

```bash git lfs install ```

• ตรวจสอบเวอร์ชันเพื่อยืนยัน

```bash git lfs version ```

กำหนดค่าใน Repository — Configure Repository

เมื่อมี repository ที่ต้องใช้ LFS ให้ทำตามขั้นตอนต่อไปนี้

• **ขั้นตอนที่ 1: เข้าโฟลเดอร์ของโปรเจค

```bash cd /path/to/your/repo ```

• **ขั้นตอนที่ 2: ระบุประเภทไฟล์ที่ต้องการให้ LFS จัดการ (ตัวอย่างเช่น *.psd, *.mp4)

```bash git lfs track "*.psd" git lfs track "*.mp4" ```

• **ขั้นตอนที่ 3: ตรวจสอบไฟล์ `.gitattributes` ที่ถูกสร้างขึ้น

```bash cat .gitattributes ```

• **ขั้นตอนที่ 4: ทำการ commit การเปลี่ยนแปลง

```bash git add .gitattributes git commit -m "Configure Git LFS for large assets" ```

ตรวจสอบการทำงาน — Verify Installation

เพื่อให้แน่ใจว่า LFS ทำงานตามคาด ให้ทดสอบโดยเพิ่มไฟล์ขนาดใหญ่ลง repository

• คัดลอกไฟล์ตัวอย่าง (เช่น `sample-video.mp4` ขนาด 200 MB) ลงโฟลเดอร์โปรเจค
• เพิ่มและ commit ไฟล์

```bash git add sample-video.mp4 git commit -m "Add large video file" ```

• พุชไปยัง remote repository

```bash git push origin main ```

• ตรวจสอบบนหน้าเว็บของ GitHub/GitLab ว่าไฟล์แสดงเป็น pointer (ข้อความ `version https://git-lfs.github.com/spec/v1`) ไม่ใช่ไฟล์ดิบ

**Tip: ใช้คำสั่ง `git lfs ls-files` เพื่อดูรายการไฟล์ที่อยู่ภายใต้การจัดการของ LFS ทั้งหมด

วิธีแก้ปัญหาที่พบบ่อย — Common Issues & Tips

บางครั้งอาจเจอข้อผิดพลาดระหว่างการติดตั้งหรือใช้งาน

• **Error: `git: 'lfs' is not a git command`
• ตรวจสอบว่าได้รัน `git lfs install` แล้วหรือยัง
• รีสตาร์ท Terminal เพื่อโหลด PATH ใหม่

• **Error: `Batch request aborted` ขณะ push
• ตรวจสอบขนาดไฟล์ว่าต่ำกว่าขีดจำกัดของ remote (เช่น GitHub มี 2 GB)
• แบ่งไฟล์ออกเป็นหลายส่วนหรือใช้บริการ storage ภายนอก

• **Warning: การทำงานช้าในขั้นตอน `git pull`
• ใช้คำสั่ง `git lfs fetch --all` เพื่อดึงไฟล์ LFS ทั้งหมดล่วงหน้า

เปรียบเทียบวิธีติดตั้ง Git LFS — Installation Options

สรุป — Summary

การตั้งค่า Git LFS บน macOS ทำได้เร็วและปลอดภัย หากทำตามขั้นตอนต่อไปนี้

• ติดตั้ง Homebrew แล้วใช้ `brew install git-lfs`
• รัน `git lfs install` เพื่อ initialise ระบบ
• ใช้ `git lfs track` ระบุไฟล์ขนาดใหญ่ที่ต้องการจัดการ
• ตรวจสอบการทำงานด้วย `git lfs ls-files` และ push ไปยัง remote

สิ่งที่ควรจำ

• อย่าเก็บไฟล์ใหญ่กว่า 2 GB ใน LFS เพราะอาจโดนบล็อกโดยบริการโฮสต์
• ทุกครั้งที่เพิ่มประเภทไฟล์ใหม่ ต้องแก้ไข `.gitattributes` แล้ว commit ใหม่
• หากพบ error ให้ตรวจสอบการ initialise และขนาดไฟล์ก่อนทำ push อีกครั้ง