Bài 01: Setup Visual Studio Code để chạy Python & Jupyter Notebook


Series: Python Cơ Bản – Học Qua Thực Hành


Vì sao phải setup môi trường trước khi học Python?

Giống như bạn học nấu ăn, trước khi cầm chảo phải có bếp, dao, và nguyên liệu. Học Python cũng vậy – trước khi viết được dòng code đầu tiên, ta cần chuẩn bị môi trường làm việc:

  • Có nơi để viết code
  • Có nơi để chạy thử và xem kết quả
  • Có công cụ hỗ trợ khi code bị lỗi

    Nếu bạn từng nghe đến những cái tên như PyCharm, Jupyter Notebook, Google Colab, hay Anaconda, thì VS Code chính là “bếp đa năng” – vừa nhẹ, vừa dễ dùng, lại chạy được tất cả.

    Trong bài này, chúng ta sẽ:

    • Cài Python – ngôn ngữ chính
    • Cài Visual Studio Code – IDE (trình viết code)
    • Cài Jupyter Notebook để chạy notebook trực quan
    • Tạo cấu trúc thư mục chuẩn cho project học Python
    • Thiết lập virtual environment (môi trường ảo) để quản lý thư viện gọn gàng
    • Và xử lý các lỗi thường gặp

    Đây là nền tảng bắt buộc trước khi bước vào “Phần 1: Làm quen với Python & thao tác cơ bản”.


    1. Cài đặt Python

    Bước 1: Truy cập trang chính thức

    Vào https://www.python.org/downloads

    Trang này sẽ tự động nhận hệ điều hành của bạn (Windows, macOS, Linux).
    Nếu bạn thấy nút Download Python 3.x.x, cứ nhấn luôn – đó là bản ổn định nhất.

    Khuyến nghị: Dùng phiên bản 3.10 trở lên, vì nhiều thư viện phân tích dữ liệu (như Pandas, Polars, Matplotlib) yêu cầu bản mới.

    Bước 2: Cài đặt Python

    Khi mở file .exe, hãy nhớ tick chọn ô “Add Python to PATH” trước khi nhấn Install Now.
    Đây là lỗi phổ biến nhất của người mới: quên tick ô này → VS Code không nhận lệnh python.

    Cài xong, bạn sẽ thấy thông báo Setup was successful.

    Bước 3: Kiểm tra xem đã cài thành công chưa

    Mở Command Prompt (hoặc PowerShell)
    Gõ:

    python --version
    

    Kết quả mong muốn:

    Python 3.12.1
    

    Nếu dòng lệnh báo not recognized, nghĩa là bạn quên tick PATH.
    → Gỡ Python và cài lại, nhớ chọn lại tùy chọn đó.

    2. Cài đặt Visual Studio Code (VS Code)

    Visual Studio Code là trình soạn thảo “all-in-one”:

    • Viết code Python, SQL, HTML, Markdown…
    • Chạy Jupyter Notebook
    • Cài extension (plugin) để mở rộng tính năng
    • Giao diện thân thiện, nhẹ và dễ tùy chỉnh

      Bước 1: Tải về

      Vào https://code.visualstudio.com/
      Chọn phiên bản phù hợp (Windows / macOS / Linux).
      Tải về → Cài đặt theo hướng dẫn mặc định.

      Bước 2: Mở VS Code

      Khi mở lần đầu, bạn sẽ thấy giao diện sạch sẽ với ba phần chính:

      • Sidebar (bên trái): chứa file, extension, debug, source control
      • Editor (giữa): nơi viết code
      • Terminal (dưới): nơi chạy lệnh

        3. Cài Extension Python & Jupyter cho VS Code

        Extension chính là “bộ não” giúp VS Code hiểu bạn đang viết gì.

        Bước 1: Mở tab Extensions

        Nhấn Ctrl + Shift + X (hoặc click biểu tượng ô vuông ở thanh trái).

        Bước 2: Tìm và cài:

        • Python – của Microsoft
        • Jupyter – của Microsoft

          Cả hai extension này là “cặp đôi hoàn hảo”:

          • Python giúp chạy script .py
          • Jupyter giúp mở file .ipynb (Notebook)

            Bước 3: Khởi động lại VS Code

            Sau khi cài, khởi động lại để VS Code load đầy đủ extension.

            Mẹo nhỏ: Bạn có thể cài thêm extension Pylance (gợi ý code & bắt lỗi chính tả) và Code Runner (chạy nhanh từng đoạn code).

            4. Tạo thư mục học Python

            Để học hiệu quả, ta nên có một “sân tập” riêng cho Python.

            Bước 1: Tạo thư mục

            Ví dụ:

            D:\RabitLearnData\PythonBasic\
            

            Bước 2: Cấu trúc thư mục gợi ý

            PythonBasic/
            │
            ├── data/            # Chứa file CSV, Excel, JSON…
            ├── notebooks/       # Chứa file .ipynb (Jupyter Notebook)
            ├── scripts/         # Chứa code .py
            └── output/          # Kết quả: file xuất, hình ảnh, báo cáo
            

            Bước 3: Mở thư mục bằng VS Code

            Vào File → Open Folder → chọn PythonBasic
            VS Code sẽ hiểu đây là “workspace” mặc định của bạn.

            5. Cài Jupyter Notebook trong Python

            Bước 1: Mở terminal trong VS Code

            Nhấn **Ctrl + ** (phím dưới ESC), hoặc vào menu **View → Terminal**. Bạn sẽ thấy terminal hiện thư mục PythonBasic`.

            Bước 2: Kiểm tra pip

            pip --version
            

            Nếu không ra kết quả, bạn cần cài lại Python (bị thiếu PATH hoặc pip).

            Bước 3: Cài Jupyter

            pip install jupyter
            

            Quá trình này có thể mất 1–3 phút tùy mạng.
            Sau khi cài, bạn có thể kiểm tra:

            jupyter --version
            

            Nếu hiển thị số version → đã OK

            6. Tạo file Python và Notebook đầu tiên

            Giờ là phần thú vị nhất – chạy code đầu tiên.

            (A) Viết file .py đầu tiên

            1. Vào File → New File → Save As → scripts/hello.py
            2. Viết đoạn code:
              print("Hello, Rabit Learn Data!")
              
            3. Mở terminal (Ctrl + `), chạy:
              python scripts/hello.py
              
            4. Kết quả:
              Hello, Rabit Learn Data!
              

            Vậy là Python hoạt động ổn rồi.

            (B) Viết file .ipynb đầu tiên

            Jupyter Notebook cho phép bạn viết code và xem kết quả ngay dưới mỗi cell.

            1. Tạo file: File → New File → Save As → notebooks/hello.ipynb
            2. Khi mở file, VS Code sẽ hiển thị giao diện notebook.
            3. Ở góc trên phải → chọn Select Kernel → Python 3.x
            4. Trong cell đầu tiên, gõ:
              print("Hello, Jupyter in VS Code!")
              
            5. Nhấn Shift + Enter để chạy.

            Kết quả hiện ngay bên dưới cell:

            Hello, Jupyter in VS Code!
            

            Giờ bạn đã có thể chạy code Python y như Google Colab – nhưng ngay trên máy của mình, nhanh hơn và không phụ thuộc mạng.

            7. (Nâng cao) Tạo Virtual Environment (venv)

            Một lỗi phổ biến của người học là cài đủ loại thư viện lẫn lộn trong máy → xung đột version.
            Giải pháp: mỗi project có một môi trường riêng (virtual environment).

            Bước 1: Tạo venv

            Trong terminal:

            python -m venv .venv
            

            VS Code sẽ tạo thêm thư mục .venv/ trong project.

            Bước 2: Kích hoạt venv

            • Trên Windows:
              .venv\Scripts\activate
              
            • Trên macOS/Linux:
              source .venv/bin/activate
              
            Khi venv được kích hoạt, terminal sẽ hiển thị:
            (.venv) D:\RabitLearnData\PythonBasic>
            


            Bước 3: Cài thư viện vào venv

            pip install jupyter pandas matplotlib numpy
            

            Bây giờ, mọi gói cài mới sẽ nằm trong .venv, không ảnh hưởng đến toàn hệ thống.

            Bước 4: (Tùy chọn) Ghi lại danh sách thư viện

            pip freeze > requirements.txt
            

            File requirements.txt giúp bạn hoặc người khác có thể cài lại môi trường sau này:

            pip install -r requirements.txt
            

            Tip: Đây là chuẩn môi trường chuyên nghiệp khi làm dự án thật hoặc deploy ứng dụng.


            8. Lỗi thường gặp & cách xử lý

            Lỗi hiển thị Nguyên nhân Cách khắc phục
            python: command not found Quên tick “Add Python to PATH” khi cài Gỡ và cài lại Python, tick PATH
            pip not recognized Python cài chưa đủ PATH Mở Python Installer → chọn Modify → Add pip
            No kernel found trong notebook Chưa chọn interpreter Bấm “Select Kernel” → chọn Python 3.x
            ModuleNotFoundError Thiếu thư viện Chạy pip install <package>
            Notebook không chạy Kernel bị treo Restart Kernel hoặc đóng mở lại VS Code
            Permission denied khi kích hoạt venv Chưa có quyền Mở PowerShell với quyền Admin → Set-ExecutionPolicy RemoteSigned
            python mở Microsoft Store PATH bị trỏ sai Gỡ bản cũ, cài lại từ python.org


            9. Tips giúp VS Code dễ dùng hơn khi học Python

            1. Gợi ý tự động (IntelliSense)

            VS Code có thể gợi ý hàm, biến, và mô tả khi bạn gõ code.
            Nếu không thấy, bấm Ctrl + Space.

            2. Format code đẹp mắt

            Cài extension Black Formatter, sau đó nhấn Shift + Alt + F để căn chỉnh code tự động.

            3. Chạy nhanh từng đoạn code

            Cài Code Runner → nhấn nút “Run Code” (góc phải trên) để chạy ngay.

            4. Dùng Markdown cell trong Notebook

            Trong file .ipynb, bạn có thể viết chú thích, tiêu đề bằng Markdown:

            # Phần 1: Làm quen với Python
            ## Cấu trúc dữ liệu cơ bản
            

            5. Ẩn/hiện thanh Terminal

            Nhấn Ctrl + ` để bật/tắt terminal nhanh chóng.

            10. Gợi ý ảnh minh họa cho bài blog

            Ảnh Mô tả gợi ý Alt text
            1 Giao diện VS Code với Extensions Python + Jupyter “VS Code Extensions for Python and Jupyter”
            2 Terminal chạy pip install jupyter “Install Jupyter in VS Code terminal”
            3 Cấu trúc folder PythonBasic (data, scripts, notebooks, output) “Folder structure for Python learning project”
            4 File hello.py in VS Code với output “Hello, Rabit Learn Data!” “Run Python script in VS Code”
            5 Notebook hello.ipynb đang chạy cell đầu tiên “Run Jupyter Notebook in VS Code”

            11. Tổng kết

            Đến đây, bạn đã có toàn bộ nền tảng để bắt đầu học Python chuyên nghiệp:

            ✅ Đã cài Python thành công
            ✅ Đã có VS Code – công cụ code “all-in-one”
            ✅ Đã tích hợp Jupyter Notebook để chạy notebook trực quan
            ✅ Đã biết tạo folder gọn gàng cho project
            ✅ Đã biết tạo môi trường ảo riêng để quản lý thư viện
            ✅ Và đã chạy được dòng code đầu tiên

            Từ phần sau, ta sẽ thật sự bắt đầu học Python từ gốc – từ “Hello World”, biến, kiểu dữ liệu, cho tới list, dict, và hàm.

            Lời khuyên nhỏ từ “Rabit Learn Data”

            “Đừng cài cho xong. Hãy hiểu tại sao mình cài như vậy.”

            Khi setup môi trường, bạn đang rèn tư duy kỹ thuật: biết cách chuẩn bị, kiểm tra, xử lý lỗi.
            Đây là thói quen quan trọng nhất của người làm dữ liệu.

            Bạn có thể thử:

            • Tạo thêm vài file thử nghiệm, ví dụ math_test.py để tính toán đơn giản.
            • Cài thử pandas, import thử và đọc một file CSV mẫu.
            • Ghi chú lại các lệnh cơ bản trong notebook – coi như cuốn sổ tay đầu tiên của bạn.

            Đăng nhận xét

            0 Nhận xét