TL;DR
Mở Command Palette (Ctrl+Shift+P / Cmd+Shift+P), chạy lệnh Python: Select Interpreter, rồi chọn phiên bản Python bạn muốn dùng. Nếu virtualenv của bạn không xuất hiện trong danh sách, hãy dán đường dẫn vào thủ công.
Nguyên nhân gây ra lỗi này
Extension Python cần biết binary nào sẽ được sử dụng — cho IntelliSense, linting, debugger và terminal tích hợp. Nếu thiếu cấu hình này, bạn sẽ thấy thông báo:
No Python interpreter is selected. Please select a Python interpreter to enable features such as IntelliSense.
Các nguyên nhân phổ biến:
- Workspace mới — chưa bao giờ chọn interpreter
- Bạn đã xóa hoặc tạo lại virtualenv và đường dẫn đã lưu không còn hợp lệ
- VS Code không thể tự phát hiện môi trường
.venvhoặc conda của bạn - Extension Python vừa được cài đặt, chưa được cấu hình
- Cài Python trên Windows mà không tích chọn "Add Python to PATH"
Cách 1: Chọn interpreter qua Command Palette (thử trước tiên)
- Nhấn
Ctrl+Shift+P(Windows/Linux) hoặcCmd+Shift+P(macOS) - Gõ Python: Select Interpreter rồi nhấn Enter
- Chọn phiên bản bạn muốn từ danh sách xổ xuống
Xong? Nhìn xuống thanh trạng thái phía dưới. Lúc này sẽ hiển thị thứ gì đó như Python 3.11.4 thay vì biểu tượng cảnh báo. Đó là dấu hiệu cho thấy đã thành công.
Cách 2: Interpreter không có trong danh sách — nhập đường dẫn thủ công
Các virtualenv được tạo bên ngoài thư mục workspace thường không hiển thị. Ở đầu danh sách interpreter, chọn Enter interpreter path... rồi dẫn đến file binary Python của bạn.
Các đường dẫn thường gặp:
# Linux/macOS — virtualenv
.venv/bin/python
# Windows — virtualenv
.venv\Scripts\python.exe
# conda environment
~/miniconda3/envs/myenv/bin/python
# System Python (Linux)
/usr/bin/python3
# System Python (macOS với Homebrew)
/opt/homebrew/bin/python3
Không biết Python đang nằm ở đâu? Chạy lệnh này trong terminal:
# Linux/macOS
which python3
# Windows
where python
# Trong virtualenv đang được kích hoạt
python -c "import sys; print(sys.executable)"
Cách 3: Tạo virtualenv ngay trong workspace
VS Code tự phát hiện thư mục .venv hoặc venv nằm trực tiếp trong thư mục gốc của workspace. Nếu đặt ở chỗ khác, tính năng phát hiện tự động sẽ không hoạt động. Cách đơn giản nhất là tạo virtualenv tại chỗ:
# Tạo .venv trong thư mục dự án
python3 -m venv .venv
# Kích hoạt (Linux/macOS)
source .venv/bin/activate
# Kích hoạt (Windows)
.venv\Scripts\activate
Tải lại cửa sổ (Ctrl+Shift+P → Developer: Reload Window). VS Code sẽ tự phát hiện .venv mới và nhắc bạn chọn nó.
Cách 4: Cố định interpreter trong cài đặt workspace
Làm việc theo nhóm? Hãy khóa đường dẫn interpreter để mọi người dùng cùng một môi trường ngay khi mở dự án — không cần chọn thủ công. Thêm nội dung sau vào .vscode/settings.json:
{
"python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python"
}
Đường dẫn trên Windows (lưu ý dấu gạch chéo ngược kép):
{
"python.defaultInterpreterPath": "${workspaceFolder}\\.venv\\Scripts\\python.exe"
}
Commit file này vào repo. Lần sau khi ai đó clone repo và mở trong VS Code, interpreter đã được thiết lập sẵn.
Cách 5: Python chưa có trong PATH (Windows)
Danh sách không có tùy chọn Python nào cả? Có thể Python chưa được thêm vào PATH hệ thống.
Kiểm tra nhanh bằng terminal:
python --version
# hoặc
python3 --version
Nếu thấy thông báo 'python' is not recognized, hãy cài lại Python từ python.org. Trong quá trình cài đặt, tích chọn "Add Python to PATH" — mặc định ô này không được chọn và rất dễ bỏ qua.
Muốn sửa mà không cần cài lại? Hãy tìm vị trí Python và thêm thủ công:
# Tìm nơi Python được cài (Windows)
where python
# Vị trí thường gặp:
# C:\Users\YourName\AppData\Local\Programs\Python\Python311\
# Thêm thư mục đó vào PATH qua:
# System Properties > Environment Variables > Path > Edit
Sau khi thay đổi PATH, hãy khởi động lại VS Code hoàn toàn — không chỉ tải lại cửa sổ.
Cách 6: Môi trường Conda không được phát hiện
Các môi trường Conda thường bị bỏ sót khi bản thân conda không có trong PATH lúc VS Code khởi động. Lấy đường dẫn Python chính xác cho môi trường của bạn:
# Liệt kê tất cả môi trường conda
conda env list
# Lấy đường dẫn binary Python cho một môi trường cụ thể
conda run -n myenv python -c "import sys; print(sys.executable)"
Dán đường dẫn đó vào tùy chọn Enter interpreter path... từ Cách 2. Hoặc, kích hoạt môi trường conda trong terminal trước, rồi mở VS Code từ chính phiên terminal đó — VS Code sẽ kế thừa môi trường hiện tại.
Kiểm tra sau khi sửa
Sau bất kỳ cách sửa nào, hãy thực hiện bốn kiểm tra sau:
- Thanh trạng thái — góc dưới bên trái phải hiển thị phiên bản và tên môi trường, ví dụ
3.11.4 ('.venv': venv) - IntelliSense — mở bất kỳ file
.pynào và hover lên một import. Gợi ý kiểu dữ liệu phải xuất hiện. - Khớp với terminal — mở terminal tích hợp và xác nhận:
python --version
# Phải khớp với những gì thanh trạng thái hiển thị
- Thông báo biến mất — thông báo màu vàng "No Python interpreter" phải không còn xuất hiện nữa
Vẫn còn lỗi?
- Xác nhận Python extension (
ms-python.python) được cài từ Microsoft — không phải bản fork. Vào Extensions → tìm "Python" → kiểm tra tên nhà phát hành. - Chạy Developer: Reload Window sau mỗi lần thay đổi cài đặt trước khi kết luận rằng không có hiệu lực
- Mở Output panel (
Ctrl+Shift+U), chọn Python từ danh sách xổ xuống — log lỗi của extension nằm ở đó - Khi dùng SSH từ xa hoặc Dev Containers: interpreter phải được chọn ở phía máy chủ từ xa, không phải máy local của bạn