Mac Setup For Full Stack Developer: Cài Đặt Môi Trường Dev Từ A-Z

Đối với một developer, để có thể bắt tay ngay vào công việc sau khi nhận một chiếc MacBook mới thực ra không đơn giản như chúng ta nghĩ.
Bạn cần cài đủ thứ như:

• Browser
• IDE/Code Editor như VS Code hoặc Cursor
• Git và GitHub CLI
• Terminal và các CLI tools
• Package manager: Node.js, npm/yarn/pnpm
• PHP, Composer nếu làm Backend/Laravel
• Python nếu làm automation, AI hoặc scripting
• Docker để chạy local environment
• Database client như TablePlus hoặc DBeaver
• Postman/Bruno để test API
• Slack, Zoom, Figma... để làm việc với team
• Một loạt utility nhỏ nhưng cực kỳ hữu ích trong quá trình coding

Nếu cài từng thứ một theo cách truyền thống sẽ gặp phải 3 vấn đề sau:

• Mất thời gian: mỗi lần cài lại máy phải nhớ lại từ đầu cần cài những gì.
• Thiếu nhất quán giữa các máy: máy cá nhân và máy công ty có bộ công cụ khác nhau, dễ gây lỗi "chạy trên máy tôi thì được".
• Bỏ sót công cụ quan trọng: ví dụ quên cài Docker Compose plugin, dẫn đến lỗi khi chạy docker compose up giữa chừng dự án.
  Vì vậy, mình viết bài này để tổng hợp lại một bộ setup tương đối đầy đủ cho một Web Developer sử dụng Mac, từ những thứ cơ bản nhất cho đến các tool phục vụ Backend, Frontend, Mobile, Database và DevOps

Xác định Mac đang dùng Apple Silicon hay Intel

Trước khi cài tool, nên kiểm tra kiến trúc CPU:

uname -m

Nếu kết quả:

• arm64: thì bạn đang sử dụng Apple Silicon: M1, M2, M3, M4
• x86_64: thì đó là Intel Mac.

Việc này khá quan trọng vì một số package/tool có binary khác nhau cho: Apple Silicon và Intel

Cài Xcode Command Line Tools

Xcode Command Line Tools là bộ công cụ lập trình dạng dòng lệnh do Apple cung cấp cho hệ điều hành macOS bao gồm những thứ cơ bản mà developer thường xuyên sử dụng như:

• Trình biên dịch(Compiler): clang, llvm để dịch mã nguồn C, C++, Objective-C.
• Công cụ xây dựng (Build tools): Cung cấp xcodebuild và make để quản lý và biên dịch các dự án.
• Tiện ích dòng lệnh hữu ích: git
• Thư viện và SDK: Cung cấp các macOS SDK và tài liệu hướng dẫn (man pages) cần thiết cho việc phát triển phần mềm

Nếu không có cái này, hầu hết các tool native về sau sẽ báo lỗi.

Mở Terminal (ứng dụng có sẵn trong Applications > Utilities) và chạy:

xcode-select --install

Sau khi chạy lệnh, một cửa sổ popup "Install Command Line Developer Tools" sẽ xuất hiện. Hãy nhấn Install, chấp nhận các điều khoản và chờ quá trình cài đặt hoàn tất.
Thời gian cài đặt thường mất khoảng 5–15 phút, tùy tốc độ mạng và cấu hình máy.

Kiểm tra:

xcode-select -p
# /Applications/Xcode.app/Contents/Developer -> OK

Cài Homebrew

Homebrew là package manager phổ biến nhất cho macOS (và cũng chạy được trên Linux). Nó đóng vai trò tương tự như apt trên Ubuntu hay yum trên CentOS — cho phép cài đặt, cập nhật và gỡ bỏ phần mềm chỉ bằng một dòng lệnh.
Thay vì phải tự đi tìm từng phần mềm, chúng ta có thể cài bằng command:

brew install git

hoặc với các application GUI:

brew install --cask google-chrome

Sử dụng Homebrew sẽ có một lợi ích rất lớn đó là: Môi trường developer có thể được setup bằng code thay vì phải click từng bước. Và sau này chúng ta hoàn toàn có thể đưa danh sách các package này vào Brewfile để setup một Mac mới gần như tự động.

Để cài đặt Homebrew, Mở Terminal và chạy:

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

Xong thì thêm vào shell (mặc định là zsh):

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Từ đây trở đi, hầu hết tool terminal mình đều cài qua brew. Sạch sẽ, dễ cập nhật, dễ gỡ.

Sau khi cài xong, luôn cập nhật danh sách package trước khi cài bất cứ thứ gì khác:

brew update

Kiểm tra Homebrew đã hoạt động đúng bằng lệnh chẩn đoán:

brew doctor

Nếu thấy dòng Your system is ready to brew. nghĩa là mọi thứ đã ổn.

Cài Oh My Zsh

Cài đặt Oh My Zsh để nâng cấp trải nghiệm sử dụng Zsh Terminal với hệ thống theme, plugin, alias và nhiều tùy chỉnh hữu ích.
Tính năng:

• Giao diện (Themes): Cung cấp hàng trăm mẫu giao diện có sẵn giúp Terminal hiển thị đẹp mắt, trực quan và hiển thị các thông tin hữu ích như trạng thái Git.
• Tiện ích mở rộng (Plugins): Hỗ trợ hơn 300 plugin cho các công cụ phổ biến (Git, Docker, Node, Zsh-autosuggestions, v.v.) giúp tự động gợi ý lệnh và tăng tốc độ thao tác.
• Cấu hình đơn giản: Thay vì phải tự viết và tùy chỉnh file .zshrc phức tạp, công cụ này cấu hình sẵn các thiết lập tối ưu cho người dùng.

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Setup Terminal

Mở Terminal và thiết lập Homebrew làm profile mặc định: Terminal → Settings → Profiles → Homebrew → Default

Sau đó đóng và mở lại Terminal để áp dụng cấu hình.

Cài Đặt Terminal / CLI Applications

Đây là nhóm công cụ chạy trực tiếp trong terminal, phục vụ công việc coding hàng ngày.

brew install -y \
  wget \
  gh \
  jq \
  nvm \
  pnpm \
  eza

Giải thích từng lệnh:

• Cài nvm (Node Version Manager) — công cụ quản lý nhiều phiên bản Node.js trên cùng một máy.
• Cài pnpm — package manager cho Node.js, thay thế cho npm/yarn.
• Cài jq — công cụ xử lý và format dữ liệu JSON ngay trên terminal.
• Cài gh (GitHub CLI) — tương tác với GitHub (tạo PR, clone repo, xem issue...) mà không cần rời terminal.
• Cài eza Thay cho ls

Setup nvm

echo "source $(brew --prefix nvm)/nvm.sh" >> ~/.zshrc
source ~/.zshrc

nvm install --lts
nvm use --lts
node -v && npm -v

# Update npm to its latest version:
npm install -g npm@latest

Kiểm tra các phiên bản đã cài:

node -v
pnpm -v
git --version
jq --version
gh --version
docker --version

eza -la

Cài Đặt GUI Applications

Nhóm ứng dụng có giao diện đồ họa được cài qua Homebrew Cask (brew install --cask), giúp tránh việc tải file .dmg thủ công và click "Next" nhiều lần.

brew install --cask google-chrome
brew install --cask iterm2
brew install --cask slack
brew install --cask discord

brew install --cask visual-studio-code
brew install --cask sublime-text
brew install --cask claude-code
brew install --cask codex
brew install --cask cursor
brew install --cask antigravity
brew install --cask antigravity-ide


brew install --cask vlc
brew install --cask zoom
brew install --cask ngrok
brew install --cask obs
brew install --cask shotcut
brew install --cask rectangle

brew install --cask font-hack-nerd-font

brew install --cask alt-tab
brew install stats

brew install ffmpeg
brew install imagemagick


brew install --cask the-unarchiver


npm install -g gitignore

Giải thích:

• Homebrew sẽ tự động tải file cài đặt chính thức của từng app, giải nén, và copy vào /Applications.
• Riêng font-hack-nerd-font không phải là "app" mà là một bộ font — cần thiết để terminal hiển thị đúng icon khi dùng các theme như Powerlevel10k hay Starship.
• ffmpeg - edit videos from the command line
• imagemagick - edit images from the command line
• Stats - see my network traffic, CPU temp / usage and RAM usage at a glance.
• gitignore - Auto generate .gitignore files base on the current project type
• the-unarchiver - dùng để giải nén các tập tin.

Cài đặt Docker

Nếu chỉ chọn một tool quan trọng cho local development hiện đại, Docker chắc chắn nằm trong danh sách.

brew install docker docker-compose
brew install --cask docker-desktop

Kiểm tra:

docker --version
docker compose version

Test:

docker run hello-world

Docker giúp chúng ta tránh việc phải cài trực tiếp hàng loạt service lên Mac:

MySQL
Redis
Nginx
PHP-FPM
PostgreSQL
...

Database Client

Developer làm Backend gần như chắc chắn sẽ cần database GUI.
Hai lựa chọn phổ biến:

Sequel Ace
TablePlus
DBeaver

Sequel Ace:

brew install --cask sequel-ace

TablePlus:

brew install --cask tableplus

DBeaver:

brew install --cask dbeaver-community

Hãy chọn một tool mà team thấy phù hợp.

API Client

Khi làm Backend/API:

Postman
Bruno
Insomnia

đều là những lựa chọn tốt.

Ví dụ:

brew install --cask postman

Hoặc:

brew install --cask bruno

Cài đặt PHP / Laravel

Nếu bạn làm Laravel thì cần: PHP, Composer, Laravel

Cài PHP:

brew install php

Composer:

brew install composer

Laravel installer:

composer global require laravel/installer

Kiểm tra:

php -v
composer --version

Cài đặt Python

Python hiện nay không chỉ dành cho Data Engineer.
Web Developer cũng có thể cần Python cho:

Automation
Scripting
AI
LLM
MCP
DevOps
Data processing

Một lựa chọn mình khá thích hiện nay là uv.

brew install uv

Kiểm tra:

uv --version

Cài Python:

uv python install 3.12

Cài đặt cho IOS developer

Mở App Store và cài đặt:

• Xcode
• Apple Developer
• TestFlight
• Apple Configurator

Cài đặt cho Infra/DevOps

AWS CLI

curl -fsSL https://awscli.amazonaws.com/v2/install.sh | bash

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
aws --version

Link cài đặt

GCP

brew install --cask gcloud-cli -y

Link cài đặt

Azure

brew update && brew install azure-cli  -y

Link cài đặt

Terraform

brew tap hashicorp/tap
brew install hashicorp/tap/terraform  -y

Link cài đặt

Ansible

brew install ansible  -y
ansible --version

Link cài đặt

Kubernetes

brew install kubectl  -y
brew install helm  -y

Nếu làm Kubernetes thường xuyên, có thể cài thêm:

k9s

Link cài đặt

Window Management

MacBook có một điểm mình thấy khá bất tiện nếu làm development lâu:

Window management.

Khi làm việc thường sẽ có:

VS Code
Chrome
Terminal
Slack
Figma
Docker

Lúc này việc chia màn hình rất quan trọng.

Một lựa chọn đơn giản:

brew install --cask rectangle

Sau đó có thể nhanh chóng:

Left
Right
Top
Bottom
Maximize

Setup Git

# Set your commit name
git config --global user.name "Your Name"

# Set your commit email (use your GitHub/GitLab email)
git config --global user.email "your.email@example.com"

OS Settings

1. Finder

Mục đích: Giữ Finder gọn gàng và thuận tiện hơn khi làm việc với source code, project và file cấu hình.
Finder → Settings → General

• Show these items on the desktop → None
• New Finder windows show → Home Folder

Finder → Settings → Advanced

• Show all filename extensions → On
• Show warning before changing an extension → Off
• When performing a search → Search the Current Folder

View

• Show Status Bar → On
• Show Path Bar → On
• Show Tab Bar → On

2. Dock

Mục đích: Tiết kiệm không gian màn hình và ưu tiên sử dụng keyboard/launcher để mở và chuyển đổi ứng dụng.
System Settings → Desktop & Dock

• Size → Smallest
• Position on screen → Right
• Automatically hide and show the Dock → On

Có thể dùng Alfred để mở ứng dụng và AltTab để chuyển đổi giữa các cửa sổ.

Giải Thích Từng Ứng Dụng

Phần này đi sâu vào từng ứng dụng đã cài ở trên: nó dùng để làm gì, và tại sao chọn nó thay vì các lựa chọn thay thế.

Trình Duyệt: Google Chrome

• Link chính thức: google.com/chrome
• Chức năng: Trình duyệt web dùng để test giao diện, debug bằng Chrome DevTools, kiểm tra performance (Lighthouse), và duyệt tài liệu kỹ thuật.

Nhận xét: Chrome vẫn là lựa chọn số 1 cho dev nhờ DevTools và extension, nhưng nên cài thêm Firefox và giữ Safari để test cross-browser trước khi release.

Terminal Emulator: iTerm2

• Link chính thức: iterm2.com
• Chức năng: Thay thế cho Terminal.app mặc định của macOS, hỗ trợ split pane, search history, hotkey window, và tùy biến theme/font (kết hợp tốt với Nerd Font đã cài ở trên).

Nhận xét: iTerm2 là lựa chọn kinh điển, ổn định, miễn phí hoàn toàn và có cộng đồng lớn. Warp là lựa chọn mới hơn với trải nghiệm AI-first nhưng một số tính năng nâng cao yêu cầu tài khoản/gói trả phí.

Code Editor: Visual Studio Code

• Link chính thức: code.visualstudio.com
• Chức năng: Trình soạn thảo code chính, hỗ trợ debugging, Git tích hợp sẵn, terminal nhúng, và hàng nghìn extension (ESLint, Prettier, GitLens, Docker, v.v.).

Nhận xét: VS Code phù hợp với đa số web developer nhờ miễn phí và extension mạnh. Nếu làm việc nhiều với TypeScript/React ở dự án lớn, WebStorm đáng cân nhắc nhờ refactoring tool mạnh hơn.

Quản Lý Cửa Sổ: Rectangle

• Link chính thức: rectangleapp.com
• Chức năng: Cho phép dùng phím tắt để snap cửa sổ về nửa trái/phải, góc, hoặc full màn hình — rất hữu ích khi làm việc với nhiều màn hình hoặc split code/browser.

Nhận xét: Rectangle là lựa chọn tốt nhất cho đa số dev vì miễn phí và đủ tính năng. Moom phù hợp nếu cần layout cửa sổ phức tạp, tùy chỉnh sâu.

Giao Tiếp Nhóm: Slack và Discord

• Link chính thức: slack.com và discord.com
• Chức năng: Slack thường dùng trong môi trường công ty/doanh nghiệp để giao tiếp nhóm, tích hợp CI/CD notification, bot. Discord phổ biến hơn trong cộng đồng open-source, gaming, và nhiều dev community kỹ thuật.

Nhận xét: Dùng Slack cho công việc chính thức với công ty/khách hàng; Discord phù hợp hơn cho cộng đồng dev, group học tập, hoặc dự án side-project.

Media Player: VLC

• Link chính thức: videolan.org/vlc
• Chức năng: Phát hầu hết mọi định dạng video/audio mà không cần cài thêm codec — hữu ích khi xem lại video demo, recording buổi họp, hoặc file .mkv không mở được bằng QuickTime.

Nhận xét: VLC vẫn là lựa chọn "chống mọi tình huống" vì hỗ trợ codec rộng nhất. IINA đáng thử nếu bạn thích giao diện native macOS hơn.

Họp Trực Tuyến: Zoom

• Link chính thức: zoom.us
• Chức năng: Video call cho họp team, phỏng vấn, demo sản phẩm với khách hàng.

Nhận xét: Zoom vẫn là chuẩn phổ biến nhất cho họp với khách hàng/đối tác ngoài công ty do độ ổn định cao.

Tunneling: ngrok

• Link chính thức: ngrok.com
• Chức năng: Tạo một URL public tạm thời trỏ vào server đang chạy localhost, rất hữu ích khi test webhook (Stripe, GitHub, Telegram bot...) hoặc demo nhanh cho khách hàng mà không cần deploy.

Nhận xét: ngrok là lựa chọn nhanh nhất để bắt đầu; nếu cần tunnel lâu dài, ổn định, ưu tiên Cloudflare Tunnel.

Ghi Hình/Streaming: OBS Studio

• Link chính thức: obsproject.com
• Chức năng: Ghi lại màn hình để làm video hướng dẫn, demo tính năng, hoặc live stream code session.

Nhận xét: OBS phù hợp khi cần kiểm soát chi tiết bản ghi (nhiều nguồn, overlay, streaming trực tiếp). Loom nhanh gọn hơn cho video hướng dẫn ngắn gửi đồng nghiệp.

Chỉnh Sửa Video: Shotcut

• Link chính thức: shotcut.org
• Chức năng: Cắt ghép, chỉnh sửa video sau khi ghi bằng OBS — ví dụ cắt phần thừa trong video demo trước khi gửi khách hàng.

Nhận xét: Shotcut đủ dùng cho video demo kỹ thuật ngắn. Nếu cần dựng video chuyên nghiệp (marketing, YouTube channel), DaVinci Resolve mạnh hơn nhiều dù đường cong học tập dốc hơn.

AI Coding Tools: Claude Code và Codex

• Link chính thức: claude.com/claude-code và openai.com/codex
• Chức năng: Chạy trực tiếp trong terminal, đọc hiểu codebase, tự động sửa bug, viết test, và thực hiện các thao tác nhiều bước theo yêu cầu bằng ngôn ngữ tự nhiên.

Nhận xét: Cả Claude Code và Codex đều là "agentic" CLI tool, phù hợp cho việc tự động hóa các task lặp lại (viết test, refactor, review code) thay vì chỉ autocomplete từng dòng như Copilot truyền thống. Nên cài cả hai để so sánh trải nghiệm và chọn công cụ hợp với workflow của bạn.

Font: Hack Nerd Font

• Link chính thức: nerdfonts.com
• Chức năng: Bộ font lập trình có bổ sung glyph/icon (Git, folder, ngôn ngữ lập trình...) — cần thiết để các theme terminal như Powerlevel10k, Starship, hoặc plugin của Neovim (nvim-tree, lualine) hiển thị đúng icon thay vì ô vuông trống.

Sau khi cài, vào iTerm2 > Settings > Profiles > Text và đổi font sang Hack Nerd Font để áp dụng.

Kiểm Tra Toàn Bộ Cài Đặt

Sau khi hoàn tất, chạy nhanh loạt lệnh sau để đảm bảo mọi thứ đã sẵn sàng:

brew --version
git --version
node -v && pnpm -v
jq --version
gh --version
docker --version && docker compose version

Nếu tất cả các lệnh trả về version number mà không báo lỗi command not found, môi trường của bạn đã sẵn sàng để bắt đầu code.

Xử Lý Lỗi Thường Gặp

• brew: command not found sau khi cài xong: shell chưa load Homebrew vào PATH. Chạy lại eval "$(/opt/homebrew/bin/brew shellenv)" và thêm dòng này vào ~/.zshrc.
• nvm: command not found: quên source ~/.zshrc sau khi thêm đoạn export NVM_DIR, hoặc thêm sai đường dẫn nvm.sh (kiểm tra bằng brew --prefix nvm).
• Docker Desktop báo "Cannot connect to the Docker daemon": cần mở app Docker Desktop từ Launchpad ít nhất một lần để daemon khởi động nền, brew install --cask docker chỉ cài app chứ không tự khởi động.
• gh auth login yêu cầu xác thực: chạy gh auth login sau khi cài để liên kết tài khoản GitHub qua trình duyệt hoặc token.

Best Practices Khi Setup Máy Mới

• Lưu toàn bộ danh sách package vào một file Brewfile bằng lệnh brew bundle dump, để lần sau chỉ cần brew bundle install là khôi phục lại toàn bộ môi trường.
• Đồng bộ dotfiles (~/.zshrc, ~/.gitconfig) qua một Git repository riêng để mang theo cấu hình giữa các máy.
• Luôn chạy brew update && brew upgrade định kỳ để cập nhật bảo mật cho các công cụ CLI.
• Ưu tiên cài qua Homebrew Cask thay vì tải .dmg thủ công, vì Homebrew giúp gỡ cài đặt sạch sẽ bằng brew uninstall --cask <app>.