M01 — Cài đặt môi trường

← 00 - Lập trình là gì | Tiếp theo → 02 - Chương trình đầu tiên và cú pháp nền tảng

Mục tiêu module

Cài đặt Python 3.14 lên máy Windows

Hiểu PATH là gì và vì sao nó hay gây lỗi

Cài và cấu hình VS Code để viết Python

Chạy được lệnh Python đầu tiên

Thời lượng: ~4 giờ | Tuần: 2

Đây là tuần dễ nản nhất

Cài đặt môi trường là bước gây bực bội nhất với người mới, vì lỗi phát sinh phụ thuộc vào máy từng người. Hãy kiên nhẫn. Sau tuần này, mọi thứ sẽ dễ chịu hơn nhiều.

1. Chọn phiên bản Python

Tính đến tháng 08/2026:

Phiên bản	Trạng thái	Nên dùng?
Python 3.14.x	Bản ổn định mới nhất (3.14.7 phát hành 05/08/2026)	✅ Chọn bản này
Python 3.13.x	Vẫn được hỗ trợ	✅ Chấp nhận được
Python 3.15	Đang là bản thử nghiệm (rc1), dự kiến phát hành 10/2026	❌ Không dùng để học
Python 3.8 trở xuống	Hết vòng đời hỗ trợ	❌ Tuyệt đối không
Python 2.x	Ngừng hỗ trợ từ 2020	❌ Tuyệt đối không

Nguồn chính thức tra cứu phiên bản: https://www.python.org/downloads/

Chu kỳ phát hành của Python

Mỗi năm Python ra một phiên bản lớn (thường vào tháng 10). Mỗi phiên bản được hỗ trợ khoảng 5 năm: 2 năm sửa lỗi + 3 năm chỉ vá bảo mật. Bạn không cần chạy theo phiên bản mới nhất — code bạn viết trong lộ trình này sẽ chạy được trên mọi phiên bản Python 3.9 trở lên.

2. Cài đặt Python trên Windows

Bước 1 — Kiểm tra máy đã có Python chưa

Mở Command Prompt (nhấn Windows + R, gõ cmd, Enter), rồi gõ:

python --version

Kết quả có thể là:

Kết quả	Nghĩa là
`Python 3.14.7`	Đã có, bỏ qua bước cài đặt
`Python 3.9.2`	Có bản cũ — vẫn học được, nhưng nên cài thêm bản mới
`Python 2.7.18`	Bản quá cũ — bắt buộc cài bản mới
Không có gì / mở Microsoft Store	Chưa cài — làm tiếp bước 2
`'python' is not recognized...`	Chưa cài hoặc chưa vào PATH — làm tiếp bước 2

Bước 2 — Tải bộ cài

Vào https://www.python.org/downloads/
Trang sẽ tự nhận diện Windows và hiện nút Download Python 3.14.x
Tải file .exe về

Windows có 2 cách cài

Từ Python 3.14, python.org khuyến nghị dùng Python install manager (trình quản lý cài đặt Python) — công cụ cho phép cài nhiều phiên bản song song. Tuy nhiên với người mới, bộ cài .exe truyền thống vẫn đơn giản hơn. Hướng dẫn dưới đây dùng bộ cài truyền thống.

Tài liệu chính thức: https://docs.python.org/3/using/windows.html

Bước 3 — Chạy bộ cài (BƯỚC QUAN TRỌNG NHẤT)

Khi cửa sổ cài đặt hiện ra, ở màn hình đầu tiên, hãy làm đúng thứ tự sau:

✅ TÍCH VÀO Ô Add python.exe to PATH ở phía dưới cùng
Bấm Install Now
Chờ cài xong, bấm Close

Nếu quên tích vào ô "Add python.exe to PATH"

90% lỗi 'python' is not recognized as an internal or external command của người mới là do quên bước này.

Cách sửa: Chạy lại file cài đặt → chọn Modify → Next → tích Add Python to environment variables → Install. Hoặc gỡ cài đặt rồi cài lại từ đầu.

Bước 4 — Kiểm tra lại

Đóng hoàn toàn Command Prompt cũ, mở lại cái mới (quan trọng — PATH chỉ được nạp khi mở cửa sổ mới), gõ:

python --version

Kết quả mong đợi:

Python 3.14.7

Kiểm tra thêm pip (công cụ cài thư viện, sẽ dùng ở 15 - Môi trường ảo và pip):

pip --version

Kết quả mong đợi (đường dẫn có thể khác):

pip 25.2 from C:\Users\TenBan\AppData\Local\Programs\Python\Python314\Lib\site-packages\pip (python 3.14)

3. Hiểu về PATH — vì sao nó gây lỗi?

Đây là khái niệm nền tảng của hệ điều hành, không riêng Python. Hiểu nó sẽ giúp bạn tự xử lý được rất nhiều lỗi sau này.

PATH là gì?

PATH là một biến môi trường (environment variable) chứa danh sách các thư mục mà hệ điều hành sẽ tìm kiếm khi bạn gõ một lệnh.

Khi bạn gõ python vào Command Prompt, Windows làm thế này:

graph TD
    A["Người dùng gõ: python"] --> B{"Có file python.exe<br/>trong thư mục hiện tại?"}
    B -->|Có| C[Chạy]
    B -->|Không| D["Duyệt lần lượt từng thư mục trong PATH"]
    D --> E{"Tìm thấy python.exe?"}
    E -->|Có| C
    E -->|Không| F["Báo lỗi:<br/>'python' is not recognized"]

Vậy nên nếu Python được cài vào C:\...\Python314\ mà thư mục đó không nằm trong PATH, Windows sẽ không tìm ra, dù Python đã cài thành công.

Xem PATH hiện tại

echo %PATH%

Trong danh sách trả về, bạn phải thấy 2 đường dẫn kiểu:

C:\Users\TenBan\AppData\Local\Programs\Python\Python314\
C:\Users\TenBan\AppData\Local\Programs\Python\Python314\Scripts\

Thêm thủ công vào PATH (khi cần)

Nhấn Windows → gõ environment variables → chọn Edit the system environment variables
Bấm Environment Variables…
Ở khung User variables, chọn dòng Path → Edit
New → dán đường dẫn thư mục chứa python.exe
New → dán tiếp đường dẫn thư mục Scripts bên trong
OK → OK → mở lại Command Prompt

Tìm Python đang nằm ở đâu
where python
Lệnh này in ra đường dẫn đầy đủ tới python.exe đang được dùng. Nếu in ra nhiều dòng, dòng đầu tiên là cái đang có hiệu lực.

Lệnh `py` — cứu cánh trên Windows

Windows cài kèm một công cụ tên Python Launcher (py.exe) nằm sẵn trong C:\Windows\. Vì C:\Windows\ luôn có trong PATH, lệnh py gần như luôn chạy được:

py --version
py -0            (liệt kê mọi phiên bản Python trên máy)
py -3.14         (chạy đúng phiên bản 3.14)

Nếu python không chạy mà py chạy được

Cứ dùng py thay cho python trong toàn bộ lộ trình. Không có gì sai cả.

4. Cài đặt VS Code

Vì sao cần IDE/Editor?

Về lý thuyết bạn có thể viết Python bằng Notepad. Nhưng một code editor chuyên dụng cung cấp:

Tính năng	Lợi ích cho người mới
Syntax highlighting (tô màu cú pháp)	Từ khóa, chuỗi, số hiện màu khác nhau → dễ phát hiện gõ sai
Auto-completion (gợi ý code)	Gõ `pri` → gợi ý `print` → giảm lỗi chính tả
Error underline (gạch chân lỗi)	Báo lỗi trước cả khi chạy
Debugger (trình gỡ lỗi)	Chạy từng dòng, xem giá trị biến — cực kỳ hữu ích khi học
Integrated terminal	Chạy code ngay trong editor

So sánh 3 lựa chọn

	VS Code	PyCharm Community	Thonny
Giá	Miễn phí	Miễn phí	Miễn phí
Độ nặng	Nhẹ	Nặng	Rất nhẹ
Dễ dùng cho người mới	Trung bình	Trung bình	Rất dễ
Dùng được lâu dài	✅	✅	❌ (chỉ để học)
Khuyến nghị	✅ Chọn cái này	Nếu quen JetBrains	Nếu VS Code quá rối

Chọn VS Code vì: bạn làm IT, sẽ dùng nó cho cả SQL, Git, và nhiều việc khác sau này.

Các bước cài

Tải tại https://code.visualstudio.com/
Chạy bộ cài, ở màn hình Select Additional Tasks nên tích:
- ✅ Add "Open with Code" action to Windows Explorer file context menu
- ✅ Add "Open with Code" action to Windows Explorer directory context menu
- ✅ Add to PATH
Cài xong, mở VS Code

Cài extension Python

Trong VS Code, bấm biểu tượng Extensions ở thanh bên trái (hoặc Ctrl + Shift + X)
Gõ Python vào ô tìm kiếm
Cài extension Python của Microsoft (có dấu tick xanh, hàng trăm triệu lượt tải)
Extension này sẽ tự kéo theo Pylance (bộ phân tích code) — cứ để nó cài

Chọn Python interpreter trong VS Code

Nhấn Ctrl + Shift + P → mở Command Palette (bảng lệnh)
Gõ Python: Select Interpreter → Enter
Chọn dòng có Python 3.14.x

Vì sao phải chọn interpreter?

VS Code chỉ là trình soạn thảo, nó không tự chạy Python. Nó cần biết dùng python.exe nào để chạy file của bạn. Máy có thể có nhiều bản Python cùng lúc — bước này chỉ định rõ dùng bản nào.

5. Cấu hình VS Code cho dễ học

Nhấn Ctrl + , để mở Settings, tìm và chỉnh các mục sau:

Setting	Giá trị	Lý do
`Editor: Font Size`	15 hoặc 16	Đỡ mỏi mắt
`Editor: Render Whitespace`	`all`	Hiện dấu cách và tab — cực quan trọng với Python vì thụt lề có ý nghĩa
`Editor: Tab Size`	4	PEP 8 quy định thụt lề 4 dấu cách
`Editor: Insert Spaces`	✅ bật	Chuyển tab thành dấu cách, tránh lỗi trộn tab/space
`Files: Auto Save`	`afterDelay`	Đỡ quên Ctrl+S
`Editor: Word Wrap`	`on`	Dòng dài tự xuống dòng

Render Whitespace = all là bắt buộc

Python dùng thụt lề để phân định khối lệnh. Nếu bạn trộn lẫn Tab và Space, code trông giống hệt nhau trên màn hình nhưng Python sẽ báo lỗi TabError hoặc IndentationError. Bật hiển thị khoảng trắng giúp bạn nhìn thấy sự khác biệt.

6. Ba cách chạy code Python

Cách 1 — REPL (chế độ tương tác)

REPL = Read–Eval–Print Loop (đọc – tính – in – lặp lại). Gõ trong Command Prompt:

python

Bạn sẽ thấy:

Python 3.14.7 (main, Aug  5 2026, ...) [MSC v.1943 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>>

Dấu >>> là prompt — nghĩa là Python đang chờ lệnh. Gõ thử:

>>> 2 + 3
5
>>> print("Xin chao")
Xin chao
>>> 100 / 7
14.285714285714286

Thoát REPL:

>>> exit()

REPL giống gì trong công việc của bạn?

Rất giống cửa sổ Query Editor của SSMS hay pgAdmin: gõ một câu, chạy, xem kết quả ngay. Dùng REPL để thử nghiệm nhanh một cú pháp mà không cần tạo file.

Cách 2 — Chạy file `.py` từ terminal

Tạo file hello.py với nội dung:

print("Xin chao Python")

Chạy:

python hello.py

Đây là cách chạy thực tế khi làm việc thật.

Cách 3 — Chạy trong VS Code

Mở file .py, bấm nút ▶ (Run Python File) ở góc trên bên phải, hoặc nhấn Ctrl + F5.

7. Thực hành bắt buộc

Bài 1 — Kiểm tra cài đặt

Mở Command Prompt và chạy lần lượt, ghi lại kết quả vào Nhật ký học tập - Template:

python --version
pip --version
where python
py -0

Bài 2 — Thử nghiệm với REPL

Vào REPL (python), gõ và ghi lại kết quả:

>>> 2 ** 10
>>> 17 // 5
>>> 17 % 5
>>> "Ke" + "toan"
>>> "abc" * 3
>>> len("Hue")
>>> import this

Chưa cần hiểu hết. Mục đích là làm quen với việc gõ và thấy kết quả ngay.

Bài 3 — Tạo thư mục làm việc

Tạo cấu trúc thư mục sau trên ổ đĩa (tránh Desktop và OneDrive vì dễ phát sinh lỗi đường dẫn):

D:\hoc-python\
    ├── tuan-02\
    ├── tuan-03\
    └── ...

Tránh dấu tiếng Việt và khoảng trắng trong đường dẫn

Đặt tên thư mục hoc-python chứ không đặt Học Python. Dấu tiếng Việt và khoảng trắng trong đường dẫn là nguồn gây lỗi rất khó chẩn đoán, đặc biệt khi làm việc với file ở 13 - Làm việc với File.

Mở thư mục D:\hoc-python bằng VS Code: chuột phải vào thư mục → Open with Code.

Bài 4 — File Python đầu tiên

Trong VS Code, tạo file tuan-02/kiem_tra.py:

import sys
 
print("Chuong trinh dau tien cua toi")
print("Phien ban Python:", sys.version)
print("Duong dan Python:", sys.executable)

Chạy bằng cả 2 cách (nút ▶ trong VS Code, và python tuan-02/kiem_tra.py trong terminal). Chụp màn hình kết quả lưu vào nhật ký.

8. Xử lý sự cố thường gặp

Lỗi	Nguyên nhân	Cách sửa
`'python' is not recognized...`	Chưa vào PATH	Cài lại có tích “Add to PATH”, hoặc dùng lệnh `py`
Gõ `python` mở Microsoft Store	Windows có “app execution alias” giả	Settings → Apps → Advanced app settings → App execution aliases → tắt 2 mục `python.exe` và `python3.exe`
`pip is not recognized`	Thư mục `Scripts` chưa vào PATH	Dùng `python -m pip` thay cho `pip`
VS Code không nhận Python	Chưa chọn interpreter	`Ctrl+Shift+P` → `Python: Select Interpreter`
Chạy file báo `No such file or directory`	Đang đứng sai thư mục trong terminal	Dùng `cd` để về đúng thư mục, hoặc gõ đường dẫn đầy đủ
`SyntaxError` ngay dòng đầu	Đang chạy code Python 3 bằng Python 2	Kiểm tra `python --version`

Xem thêm ở Lỗi thường gặp và cách đọc lỗi.

9. Tự kiểm tra

python --version trả về Python 3.13 hoặc 3.14
pip --version chạy được
Tôi giải thích được PATH là gì
VS Code đã cài extension Python và chọn đúng interpreter
Tôi chạy được file .py bằng cả terminal lẫn VS Code
Tôi biết vào và thoát REPL
VS Code đã bật hiển thị khoảng trắng (Render Whitespace)

10. Tài liệu chính thức

Nguồn	Nội dung	Link
Python Downloads	Tải Python, xem phiên bản hiện hành	https://www.python.org/downloads/
Using Python on Windows	Hướng dẫn cài đặt chính thức cho Windows	https://docs.python.org/3/using/windows.html
Python Setup and Usage	Hướng dẫn sử dụng interpreter	https://docs.python.org/3/using/index.html
VS Code — Python Tutorial	Hướng dẫn cấu hình VS Code cho Python	https://code.visualstudio.com/docs/python/python-tutorial
Python Docs — 3.14	Tài liệu phiên bản 3.14	https://docs.python.org/3.14/

Tiếp theo → 02 - Chương trình đầu tiên và cú pháp nền tảng

description	Cài đặt Python 3.14 lên máy Windows
tags	python, module, setup
aliases

TungDD Wiki

Nội dung

01 - Cài đặt môi trường

M01 — Cài đặt môi trường

1. Chọn phiên bản Python

2. Cài đặt Python trên Windows

Bước 1 — Kiểm tra máy đã có Python chưa

Bước 2 — Tải bộ cài

Bước 3 — Chạy bộ cài (BƯỚC QUAN TRỌNG NHẤT)

Bước 4 — Kiểm tra lại

3. Hiểu về PATH — vì sao nó gây lỗi?

PATH là gì?

Xem PATH hiện tại

Thêm thủ công vào PATH (khi cần)

Lệnh `py` — cứu cánh trên Windows

4. Cài đặt VS Code

Vì sao cần IDE/Editor?

So sánh 3 lựa chọn

Các bước cài

Cài extension Python

Chọn Python interpreter trong VS Code

5. Cấu hình VS Code cho dễ học

6. Ba cách chạy code Python

Cách 1 — REPL (chế độ tương tác)

Cách 2 — Chạy file `.py` từ terminal

Cách 3 — Chạy trong VS Code

7. Thực hành bắt buộc

Bài 1 — Kiểm tra cài đặt

Bài 2 — Thử nghiệm với REPL

Bài 3 — Tạo thư mục làm việc

Bài 4 — File Python đầu tiên

8. Xử lý sự cố thường gặp

9. Tự kiểm tra

10. Tài liệu chính thức

Sơ đồ

Mục lục

Liên kết ngược

TungDD Wiki

Nội dung

01 - Cài đặt môi trường

M01 — Cài đặt môi trường

1. Chọn phiên bản Python

2. Cài đặt Python trên Windows

Bước 1 — Kiểm tra máy đã có Python chưa

Bước 2 — Tải bộ cài

Bước 3 — Chạy bộ cài (BƯỚC QUAN TRỌNG NHẤT)

Bước 4 — Kiểm tra lại

3. Hiểu về PATH — vì sao nó gây lỗi?

PATH là gì?

Xem PATH hiện tại

Thêm thủ công vào PATH (khi cần)

Lệnh py — cứu cánh trên Windows

4. Cài đặt VS Code

Vì sao cần IDE/Editor?

So sánh 3 lựa chọn

Các bước cài

Cài extension Python

Chọn Python interpreter trong VS Code

5. Cấu hình VS Code cho dễ học

6. Ba cách chạy code Python

Cách 1 — REPL (chế độ tương tác)

Cách 2 — Chạy file .py từ terminal

Cách 3 — Chạy trong VS Code

7. Thực hành bắt buộc

Bài 1 — Kiểm tra cài đặt

Bài 2 — Thử nghiệm với REPL

Bài 3 — Tạo thư mục làm việc

Bài 4 — File Python đầu tiên

8. Xử lý sự cố thường gặp

9. Tự kiểm tra

10. Tài liệu chính thức

Sơ đồ

Mục lục

Liên kết ngược

Lệnh `py` — cứu cánh trên Windows

Cách 2 — Chạy file `.py` từ terminal