Cài đặt Anaconda trên macOS (2026): Apple Silicon, conda init và các cách khắc phục thường gặp

Trước đây, cài đặt Anaconda trên Mac khá đơn giản: tải về, bấm, xong. Hiện nay, khác biệt kiến trúc (Apple Silicon so với Intel cũ), khởi tạo shell và xung đột PATH khiến bạn dễ gặp lỗi “conda: command not found”, chạy bản Intel chậm dưới Rosetta, hoặc Jupyter khởi chạy mãi không lên.

Tôi tránh các trường hợp lỗi đó bằng một danh sách kiểm tra đơn giản: chọn đúng bộ cài, xác minh checksum, để trình cài đặt chạy conda init, khởi động lại Terminal và kiểm tra bằng một môi trường mới. Các bước dưới đây phản ánh cách làm hoạt động ổn định trên các bản macOS hiện tại (Sonoma 14 và Sequoia 15).

Anaconda là gì?

Anaconda là một bản phân phối Python đóng gói Python và hàng trăm thư viện khoa học (NumPy, pandas, SciPy, scikit-learn, v.v.). Nó bao gồm trình quản lý gói và môi trường conda để bạn cài đặt gói dựng sẵn và giữ cho phụ thuộc dự án được tách biệt.

Lưu ý về giấy phép quan trọng (Cập nhật 2026)

Từ tháng 7/2025, Anaconda Individual Edition miễn phí hỗ trợ sử dụng bởi cá nhân, cơ sở giáo dục, tổ chức phi lợi nhuận và doanh nghiệp vì lợi nhuận có tối đa 200 nhân viên hoặc nhà thầu. Tổ chức có hơn 200 nhân viên hoặc nhà thầu phải mua giấy phép Business (hoặc Enterprise) theo điều khoản của Anaconda.

Xem Điều khoản Dịch vụ của Anaconda hiện hành để biết chi tiết.

Chọn bộ cài phù hợp cho máy Mac của bạn

Trước khi tải xuống, hãy xác nhận kiến trúc của máy Mac và chọn bộ cài tương ứng từ trang chính thức.

• Apple Silicon (M1/M2/M3): Dùng bản macOS ARM64 (osx-arm64). Bản này chạy gốc và cho hiệu năng tốt nhất.
• Intel Macs: Các bản Intel (osx-64) mới phần lớn đã ngừng phát hành từ giữa 2025. Bạn có thể dùng bộ cài lưu trữ hoặc cân nhắc Miniforge/Miniconda.

Kiểm tra kiến trúc của bạn:

uname -m # prints 'arm64' on Apple Silicon, 'x86_64' on Intel

Tải bộ cài từ trang Anaconda chính thức: https://www.anaconda.com/download

Cài đặt giao diện đồ họa (.pkg) trên macOS

Trình cài đặt đồ họa là cách nhanh nhất để cài Anaconda trên macOS và phù hợp với hầu hết người dùng.

Xác minh checksum của bộ cài

shasum -a 256 ~/Downloads/Anaconda3-2025.06-0-MacOSX-arm64.pkg

Nếu checksum không khớp, hãy tải lại hoặc gỡ thuộc tính cách ly của macOS trước khi kiểm tra lại:

xattr -dr com.apple.quarantine ~/Downloads/Anaconda3-2025.06-0-MacOSX-arm64.pkg

Chạy trình cài đặt

Nhấp đúp vào tệp .pkg. Nếu được yêu cầu, hãy cung cấp thông tin quản trị viên.

Chọn vị trí cài đặt:

• Mặc định (không cần sudo): /Users/<username>/anaconda3

• Toàn hệ thống (cần sudo): /opt/anaconda3

Cho phép trình cài đặt chạy conda init khi được hỏi. Đóng trình cài đặt, sau đó đóng và mở lại Terminal.

Xác minh cài đặt

which conda conda list | head python3 --version

Nếu mọi thứ ổn, which conda sẽ trỏ tới thư mục Anaconda của bạn và conda list sẽ in ra nhiều gói.

Cài đặt qua dòng lệnh (.sh) trên macOS

Trình cài đặt dòng lệnh cho phép bạn toàn quyền kiểm soát vị trí cài đặt và phù hợp cho kịch bản tự động hoặc thiết lập không màn hình.

Xác minh checksum

shasum -a 256 ~/Downloads/Anaconda3-2025.06-0-MacOSX-arm64.sh

Chạy trình cài đặt

cd ~/Downloads bash Anaconda3-2025.06-0-MacOSX-arm64.sh

Khi được hỏi về đường dẫn cài đặt:

• /opt/anaconda3 cho cài đặt toàn hệ thống (cần quyền quản trị), hoặc

• ~/anaconda3 cho cài đặt cục bộ cho người dùng (không cần quyền quản trị).

Trả lời “yes” cho conda init, rồi đóng và mở lại Terminal.

Xác minh cài đặt

which conda conda info 

macOS hiện đại dùng zsh theo mặc định, vì vậy tệp hồ sơ của bạn thường là ~/.zshrc.

Nếu conda không có sau khi cài, hãy khởi tạo thủ công:

echo $SHELL # should print /bin/zsh conda init zsh # Then close and reopen Terminal which conda

Nếu bạn dùng Bash:

conda init bash

Không chỉnh sửa hoặc xóa Python hệ thống trong /usr/bin.

Xác minh cài đặt của bạn

Các kiểm tra nhanh để xác nhận Anaconda và Python hoạt động:

conda list | head python3 --version which python3 python3 -c "import sys; print(sys.executable)"

Tùy chọn: xác nhận Jupyter chạy được:

jupyter lab # or: jupyter notebook

Tạo và sử dụng môi trường tách biệt

Tránh làm việc trong môi trường base. Hãy tạo một môi trường cho mỗi dự án.

# Create a new environment
conda create -n analytics-env python=3.11 -y

# Activate the environment
conda activate analytics-env

# Install common libraries
conda install numpy pandas -y

# Verify installation
python3 -c "import numpy as np, pandas as pd; print(np.__version__, pd.__version__)"

Hủy kích hoạt khi xong việc:

conda deactivate

Ưu tiên conda cho gói (dùng pip khi cần)

Cài các gói khoa học bằng conda khi có thể. Chỉ dùng pip khi gói không có qua conda.

# conda-first approach
conda install scikit-learn

# fallback to pip (if the package isn't available via conda)
pip install package-name

Các lựa chọn thay thế: Miniconda, Miniforge và Mambaforge

Nếu bạn muốn cài gọn nhẹ hơn hoặc cần phương án tuân thủ giấy phép cho môi trường doanh nghiệp, hãy cân nhắc các lựa chọn sau:

• Miniconda: Trình cài tối giản (~400 MB) chỉ gồm Python và conda.
• Miniforge / Mambaforge: Bộ cài cộng đồng mặc định dùng conda-forge (hoàn toàn mã nguồn mở, không hạn chế thương mại).
• Mambaforge bổ sung mamba để giải quyết phụ thuộc nhanh hơn nhiều.

Bộ cài: https://github.com/conda-forge/miniforge

Sự cố thường gặp và cách khắc phục

conda: command not found

conda init zsh 
# close and reopen Terminal which conda

Sai kiến trúc trên Apple Silicon

# Check system architecture (hardware)
uname -m

# Check Python interpreter architecture
python3 -c "import platform; print(platform.machine())"

Nếu đầu ra là x86_64, hãy gỡ và cài lại bản ARM64.

Kết thúc hỗ trợ Mac Intel

Từ giữa 2025, các bản Intel (osx-64) mới không còn được duy trì. Hãy dùng bộ cài lưu trữ hoặc Miniforge/Miniconda.

Trình cài không thể ghi vào /opt

Chạy lại trình cài và đổi đích đến sang thư mục nhà của bạn (ví dụ, ~/anaconda3).

Cài đặt qua Homebrew

Tránh cài Anaconda qua Homebrew — cách này đã lỗi thời và thường làm hỏng việc phân giải PATH. Hãy dùng bộ cài chính thức hoặc của cộng đồng.

Trùng lặp đường dẫn Anaconda

Chỉnh tệp cấu hình shell và xóa các mục trùng lặp:

# Open your shell profile for editing
nano ~/.zshrc    # or: nano ~/.bash_profile

# (Inside the file) remove extra PATH entries for older Anaconda installs
# Then save and exit (Ctrl+O, Enter, Ctrl+X)

# Reload your updated profile
source ~/.zshrc

# Verify that conda is now pointing to the correct path
which conda

Jupyter không mở được

Đảm bảo môi trường đang được kích hoạt và jupyterlab đã được cài trong đó:

# Activate your environment
conda activate analytics-env

# Install JupyterLab inside the environment
conda install jupyterlab -y

# Launch JupyterLab
jupyter lab

Đừng xóa Python hệ thống

macOS có sẵn Python hệ thống. Hãy để nguyên. Luôn dùng Python từ môi trường conda của bạn.

Gỡ cài đặt hoặc cập nhật Anaconda

Cập nhật an toàn:

# Update conda itself
conda update conda

# (Optional) Update all packages in the current environment — use cautiously
conda update --all

Dọn dẹp và gỡ bỏ:

# Install the Anaconda cleanup utility
conda install anaconda-clean -y

# Run the cleanup tool (removes configs, cache, and settings)
anaconda-clean --yes

# Manually delete the Anaconda installation directory
# (Use caution — this permanently removes the files)
rm -rf ~/anaconda3   # or: sudo rm -rf /opt/anaconda3

Đồng thời xóa các dòng khởi tạo trong ~/.zshrc hoặc ~/.bash_profile.

Kết luận

Cài đặt Anaconda thành công trên macOS phụ thuộc vào vài lựa chọn then chốt:

• Dùng đúng kiến trúc (ARM64 trên Apple Silicon).
• Xác minh tệp tải về.
• Cho phép conda init và khởi động lại Terminal.
• Làm việc trong các môi trường theo từng dự án.
• Tuân thủ giấy phép: dùng Miniforge hoặc Miniconda cho môi trường doanh nghiệp hoặc mục đích thương mại.

Với các bước này, conda, Python và Jupyter sẽ hoạt động ổn định, và bạn sẽ tránh được cả rủi ro kỹ thuật lẫn giấy phép.