Lỗi 'adb' is not recognized trên Windows: cách sửa nhanh

Bạn gõ adb devices và Windows trả lời:

'adb' is not recognized as an internal or external command,
operable program or batch file.

Trong PowerShell, thông báo là adb : The term 'adb' is not recognized..., còn trên macOS hoặc Linux là adb: command not found. Tất cả đều có cùng một ý nghĩa: máy tính không tìm thấy chương trình adb. Hoặc là adb chưa được cài, hoặc thư mục chứa nó chưa nằm trong PATH.

Bước 1: tải platform-tools

ADB nằm trong gói Android SDK Platform-Tools miễn phí của Google.

1. Tải Platform-Tools cho hệ điều hành của bạn từ trang chính thức dành cho nhà phát triển Android.
2. Giải nén vào một chỗ cố định, ví dụ C:\platform-tools trên Windows hoặc ~/platform-tools trên macOS và Linux.

Nếu đã cài Android Studio, bạn đã có sẵn gói này, thường nằm ở %LOCALAPPDATA%\Android\Sdk\platform-tools trên Windows hoặc ~/Library/Android/sdk/platform-tools trên macOS.

Thử nhanh mà không cần thay đổi gì

Mở terminal ngay trong thư mục platform-tools và chạy adb từ đó:

• Windows Command Prompt: cd C:\platform-tools, sau đó adb devices
• Windows PowerShell: cd C:\platform-tools, sau đó .\adb devices (PowerShell cần có .\)
• macOS / Linux: cd ~/platform-tools, sau đó ./adb devices

Nếu cách này chạy được, adb không có vấn đề gì, chỉ là thiếu PATH.

Bước 2: thêm platform-tools vào PATH trên Windows

1. Bấm Start, gõ environment variables và mở Edit the system environment variables.
2. Bấm Environment Variables....
3. Trong phần User variables, chọn Path và bấm Edit.
4. Bấm New và nhập C:\platform-tools (thư mục thực tế của bạn).
5. Bấm OK ở tất cả các cửa sổ.
6. Đóng rồi mở lại terminal. Các cửa sổ cũ vẫn giữ PATH cũ.

Kiểm tra bằng adb version.

Bước 2: thêm platform-tools vào PATH trên macOS và Linux

Thêm dòng này vào ~/.zshrc (macOS) hoặc ~/.bashrc (đa số bản phân phối Linux):

export PATH="$HOME/platform-tools:$PATH"

Sau đó mở terminal mới, hoặc chạy source ~/.zshrc, rồi kiểm tra bằng adb version. Trên macOS bạn cũng có thể cài bằng Homebrew (brew install --cask android-platform-tools), còn trên Debian hoặc Ubuntu thì dùng sudo apt install adb.

Có nhiều bản adb

Phần mềm quản lý điện thoại, trình giả lập và các bản SDK cũ thường kèm theo adb riêng. Nếu adb version vẫn hiện phiên bản cũ sau khi bạn đã cài bản mới, nghĩa là một bản khác đang đứng trước trong PATH. Trên Windows, where adb liệt kê mọi bản theo thứ tự. Trên macOS và Linux, dùng which -a adb. Hãy xóa thư mục cũ khỏi PATH hoặc đưa thư mục mới lên đầu. Việc trộn lẫn nhiều phiên bản cũng là lý do thường gặp khiến thiết bị bị offline.

Bỏ qua phần cài đặt với ADBKit

Nếu bạn chỉ cần các tác vụ ADB thường ngày, bạn hoàn toàn không cần adb trên máy tính. ADBKit chạy ADB ngay trong Chrome hoặc Edge qua USB: màn hình trực tiếp, gõ phím, logcat, shell, truyền tệp và cài APK, không phải cài gì và không phải thêm gì vào PATH. Trên laptop công ty bị khóa quyền cài phần mềm, đây thường là cách dễ nhất.

Bước tiếp theo khi adb đã chạy: bật gỡ lỗi USB và lưu sẵn bảng tra cứu lệnh ADB.