Buzz
Khắc phục lỗi Homebrew trên terminal zsh chỉ trong vài phút
Bạn vừa cài đặt Homebrew nhưng Terminal không nhận diện lệnh brew? Homebrew là công cụ quản lý gói mạnh mẽ dành cho macOS và Linux. Dù quá trình cài đặt khá đơn giản, một số bước quan trọng dễ bị bỏ qua. Nếu thiếu những bước này, lệnh brew sẽ không hoạt động và báo lỗi “zsh: command not found: brew”. Bài viết này sẽ giải thích nguyên nhân phổ biến gây lỗi và cách khắc phục hiệu quả.
Cách sửa lỗi Zsh: Command Not Found: Brew
Lỗi này thường xảy ra khi Homebrew chưa được cài đặt hoặc đường dẫn chưa được thêm vào file cấu hình shell. Đầu tiên, khởi động lại Terminal để làm mới phiên làm việc. Nếu không hiệu quả, hãy kiểm tra xem Homebrew đã được cài đặt chưa. Nếu có, bạn cần thêm đường dẫn của Homebrew vào file .zprofile.
Các bước thực hiện
Lỗi "zsh: Command Not Found: Brew" có nghĩa là gì?
Lỗi này cho thấy Homebrew chưa được cài đặt đúng cách. Khi Terminal không nhận diện được lệnh brew, nhiều khả năng bạn chưa hoàn tất quá trình cài đặt Homebrew. Có thể Homebrew chưa được cài đặt hoàn chỉnh, hoặc file cấu hình shell chưa được cập nhật đường dẫn chính xác. Trong một số trường hợp, bạn chỉ cần làm mới phiên làm việc shell nếu vừa mới cài đặt Homebrew.
Khởi động lại Terminal
-
Đóng và mở lại Terminal. Đôi khi giải pháp đơn giản chỉ là bắt đầu một phiên làm việc mới. Thông thường, bạn cần khởi động lại Terminal ngay sau khi cài đặt Homebrew để nó hoạt động chính xác.
-
Chạy lệnh brew doctor. Sau khi khởi động lại, hãy chạy lệnh này để kiểm tra trạng thái Homebrew. Nếu hoạt động bình thường, bạn sẽ thấy thông báo Your system is ready to brew.
- Nếu phiên bản Homebrew đã cũ, lệnh này có thể kích hoạt quá trình cập nhật, có thể mất vài phút để hoàn tất.
- Nếu vẫn thấy lỗi zsh: command not found khi chạy brew doctor, nghĩa là Homebrew chưa được cài đặt đúng cách hoặc $PATH chưa được thiết lập trong file cấu hình shell.
Kiểm tra lại quá trình cài đặt Homebrew
-
Nhập lệnh brew --version. Nếu Homebrew đã được cài đặt, Terminal sẽ hiển thị phiên bản hiện tại (ví dụ: Homebrew 4.4.21).
- Bạn cũng có thể dùng lệnh brew doctor để kiểm tra, nhưng cần chỉ rõ đường dẫn đầy đủ:
- Với chip Apple Silicon (M1, M2, M3 hoặc M4): /opt/homebrew/bin/brew doctor
- Mac đời cũ dùng Intel: /usr/local/bin/brew doctor
- Trên Linux: /home/linuxbrew/.linuxbrew/bin/brew doctor
- Nếu nhận được thông báo Your system is ready to brew, nghĩa là Homebrew đã cài đặt nhưng $PATH chưa được thiết lập trong file cấu hình shell.
- Nếu Homebrew chưa được cài đặt, bạn cần thực hiện cài đặt trước khi tiếp tục. Tham khảo hướng dẫn chi tiết trên trang chủ Homebrew.
- Bạn cũng có thể dùng lệnh brew doctor để kiểm tra, nhưng cần chỉ rõ đường dẫn đầy đủ:
Thiết lập PATH
Xác định vị trí cài đặt Homebrew. Sau khi cài đặt, bạn cần cập nhật file cấu hình shell để sử dụng lệnh brew. Trước tiên cần biết đường dẫn mặc định trên hệ thống của bạn:
- Mac dùng chip Apple Silicon (M1, M2, M3 hoặc M4): /opt/homebrew
- Mac đời cũ dùng Intel: /usr/local
- Trên Linux: /home/linuxbrew/.linuxbrew
Cập nhật thủ công file cấu hình nếu cần. Nếu bỏ qua bước này khi cài đặt, bạn có thể chỉnh sửa sau theo cách sau:
- Tạo file cấu hình bằng lệnh: touch ~/.zprofile
- Mở file bằng TextEdit: open -e ~/.zprofile
- Thêm dòng sau: eval "$(<Đường dẫn Homebrew>/bin/brew shellenv)"
- Thay "<Đường dẫn Homebrew>" bằng đường dẫn phù hợp (ví dụ: "/opt/homebrew" với chip Apple Silicon)
Đóng và mở lại Terminal. Sau khi cập nhật file cấu hình, cần khởi động lại shell. Bạn có thể đóng Terminal hoặc dùng lệnh source ~/.zprofile để làm mới môi trường shell.
- Sau khi khởi động lại, bạn đã có thể sử dụng lệnh brew!
-
Trong một số ít trường hợp, lỗi Command Not Found vẫn xuất hiện dù Homebrew đã được cài đặt và $PATH được thiết lập đúng. Khi đó, bạn có thể cần gỡ bỏ và cài đặt lại Homebrew. Hướng dẫn chi tiết về cách gỡ cài đặt Homebrew có thể được tìm thấy tại đây.
