Giới Thiệu

Bạn đã thiết lập môi trường phát triển lý tưởng của mình. Hệ thống host của bạn (có thể là Pop!_OS, Ubuntu hoặc tương tự) sử dụng pyenv để quản lý nhiều phiên bản Python. Để có các bản build sạch và có thể tái tạo, bạn khởi động một container Fedora với Distrobox. Tuy nhiên, đôi khi mọi thứ không như mong đợi.

Khi bạn nhập lệnh sau trong container:

~$ which python3
~/.pyenv/shims/python3  😖😩

Thay vì chỉ ra Python của Fedora, nó lại trỏ đến ~/.pyenv/shims/python3 của hệ thống host. Container của bạn không còn sạch nữa — môi trường host đã rò rỉ vào trong.

Đừng lo lắng. Đây là một vấn đề phổ biến và cách khắc phục rất đơn giản khi bạn hiểu điều gì đang xảy ra.

⚡ Thủ Phạm Ẩn Giấu: Hàm Shell Pyenv

Ban đầu, bạn có thể nghĩ rằng vấn đề chỉ nằm ở $PATH. Nhưng đó chỉ là một phần của câu chuyện.

Vấn đề thực sự là một hàm shell pyenv. Khi bạn chạy lệnh sau trên host:

eval "$(pyenv init -)"

Lệnh này không chỉ thay đổi đường dẫn của bạn. Nó còn tạo ra một hàm thay thế cho python. Hàm này được sao chép vào container Distrobox và ưu tiên hơn bất kỳ sửa đổi đường dẫn nào bạn thử.

Vì vậy, để giải quyết vấn đề này:
👉 Bạn cần gỡ bỏ hàm shell và làm sạch đường dẫn bên trong container.

🛠️ Giải Pháp Thông Minh Cho .bashrc

Giải pháp tốt nhất là làm cho .bashrc của bạn trở nên “thông minh.” Với một khối mã, nó có thể phát hiện bạn đang ở host (Pop!_OS/Ubuntu) hay trong một container (Fedora hoặc khác).

Thay thế các thiết lập pyenv hiện tại của bạn bằng khối mã sau:

# ==================================================================
# Cách Ly Pyenv & Distrobox
# ==================================================================
# Hoạt động trên host (Pop!_OS, Ubuntu, v.v.) và giữ cho các container (Fedora, v.v.) hoàn toàn sạch.

if [ -z "$CONTAINER_ID" ]; then
    # --- HỆ THỐNG HOST ---
    # Cài đặt pyenv bình thường
    export PYENV_ROOT="$HOME/.pyenv"
    export PATH="$PYENV_ROOT/bin:$PATH"
    eval "$(pyenv init -)"

else
    # --- GUEST (Container Distrobox) ---
    # Tẩy sạch môi trường thừa kế từ host.

    # 1. Vô hiệu hóa hàm shell pyenv
    pyenv() {
      : # Không làm gì cả
    }

    # 2. Xây dựng lại PATH mà không có các mục pyenv
    _CLEAN_PATH=""
    OLD_IFS="$IFS"; IFS=':';
    for p in $PATH; do
        case "$p" in
            # Bỏ qua bất kỳ đường dẫn nào chứa .pyenv
            */.pyenv*)
                ;; # Bỏ qua các đường dẫn pyenv
            *)
                if [ -n "$p" ]; then
                    _CLEAN_PATH="${_CLEAN_PATH:+$_CLEAN_PATH:}$p"
                fi
                ;;
        esac
    done
    # Đưa các đường dẫn bản địa của container lên đầu để đảm bảo ưu tiên.
    export PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:${_CLEAN_PATH}"
    IFS="$OLD_IFS"
    unset _CLEAN_PATH OLD_IFS
fi

Sau khi lưu lại, đóng và mở lại terminal của bạn.

• Trên host (Pop!_OS/Ubuntu), pyenv hoạt động như thường lệ.
• Bên trong container Fedora, bạn sẽ có một môi trường Python sạch, bản địa tại /usr/bin/python3 🤩😍.

✅ Tại Sao Đây Là Giải Pháp Đúng

Đây không phải là một mẹo nhanh - đây là một giải pháp sạch sẽ, dài hạn.

Ưu điểm:

• Thiết lập một lần: Cập nhật .bashrc một lần và quên đi.
• Cách ly thực sự: Cả $PATH và hàm shell đều được xử lý.
• Tương lai: Nếu bạn cài đặt pyenv bên trong container sau này, nó sẽ hoạt động đúng.
• Ranh giới rõ ràng: Giữ cho host và container tách biệt.

Nhược điểm:

• Chỉ hoạt động với bash. Nếu bạn sử dụng zsh hoặc fish, bạn sẽ cần điều chỉnh.
• Phụ thuộc vào việc .bashrc được tải đúng cách.

🎯 Kết Luận

Với cách khắc phục này, bạn sẽ nhận được lợi ích của cả hai thế giới:

• Host (Pop!_OS/Ubuntu, v.v.): sức mạnh đầy đủ của pyenv.
• Container (Fedora hoặc các khách Distrobox khác): môi trường Python sạch, cách ly.

Bây giờ bạn có thể lập trình một cách tự tin, mà không lo pyenv xâm nhập vào những nơi không thuộc về nó.