About Lesson
[Khóa học PyCardano] Bài 2: Hướng dẫn Cài đặt Môi trường Phát triển trên Windows
Chào mừng các bạn quay trở lại với khóa học PyCardano.
Ở bài trước, chúng ta đã nắm được tổng quan về lộ trình. Hôm nay, chúng ta sẽ bắt tay vào việc quan trọng đầu tiên: Xây dựng “căn cứ địa” cho việc lập trình.
Mặc dù Cardano (và blockchain nói chung) thường ưu ái môi trường Linux/Unix, nhưng với Python và PyCardano, việc phát triển trên Windows vẫn cực kỳ mượt mà nếu bạn thiết lập đúng cách ngay từ đầu. Bài viết này sẽ hướng dẫn bạn từng bước để cài đặt một môi trường sạch, chuẩn và sẵn sàng để code dApp.
1. Cài đặt Python (Nền móng)
PyCardano là thư viện Python, nên dĩ nhiên chúng ta cần Python. Tuy nhiên, một lỗi rất phổ biến của người dùng Windows là cài đặt nhưng không cấu hình đường dẫn (Path), dẫn đến việc gõ lệnh python hay pip bị lỗi.
Bước 1: Tải bộ cài
- Truy cập trang chủ: python.org/downloads
- Tải phiên bản ổn định mới nhất (Khuyên dùng Python 3.10 hoặc 3.11 để tương thích tốt nhất với các thư viện hiện tại).
Bước 2: Cài đặt (Lưu ý quan trọng)
- Chạy file .exe vừa tải.
- QUAN TRỌNG: Ở màn hình cài đặt đầu tiên, bạn BẮT BUỘC phải tích vào ô:☑ Add Python.exe to PATH
- Sau đó chọn Install Now.
Bước 3: Kiểm tra
Mở Command Prompt (CMD) hoặc PowerShell và gõ:
python –version
Nếu hiện ra Python 3.x.x là bạn đã thành công.
2. Cài đặt IDE (Công cụ lập trình)
Mình khuyến nghị sử dụng Visual Studio Code (VS Code). Đây là Editor nhẹ, hỗ trợ Python tuyệt vời và có terminal tích hợp rất tiện lợi.
- Tải và cài đặt tại: code.visualstudio.com
- Sau khi cài xong, vào tab Extensions (biểu tượng 4 ô vuông bên trái), tìm và cài đặt Extension tên là Python (của Microsoft).
3. Tạo môi trường ảo (Virtual Environment)
Đây là bước bắt buộc trong thói quen lập trình chuyên nghiệp. Môi trường ảo giúp cách ly các dự án. Bạn không nên cài PyCardano trực tiếp vào hệ thống (global) vì sẽ gây xung đột thư viện sau này.
Bước 1: Tạo thư mục dự án
Tạo một thư mục mới cho khóa học, ví dụ PyCardano-Course, sau đó mở thư mục này bằng VS Code.
Bước 2: Khởi tạo môi trường ảo
Mở Terminal trong VS Code (Ctrl + ~) và gõ lệnh:
python -m venv venv
(Lệnh này tạo một thư mục tên là venv chứa môi trường riêng biệt).
Bước 3: Kích hoạt môi trường (Activate)
Để Windows hiểu là bạn muốn dùng môi trường này, bạn cần kích hoạt nó:
- Với Command Prompt (cmd):
venvScriptsactivate - Với PowerShell:
.venvScriptsactivate
> Lưu ý: Nếu PowerShell báo lỗi “execution of scripts is disabled”, hãy chạy lệnh Set-ExecutionPolicy RemoteSigned -Scope CurrentUser rồi thử lại.
Khi kích hoạt thành công, bạn sẽ thấy chữ (venv) xuất hiện ở đầu dòng lệnh.
4. Cài đặt thư viện PyCardano
Bây giờ, khi đã ở trong môi trường ảo (venv), chúng ta sẽ cài đặt nhân vật chính.
Chạy lệnh sau trong terminal:
pip install pycardano
Ngoài ra, để thuận tiện cho các bài sau (kết nối với Blockfrost), mình khuyên bạn cài luôn gói blockfrost-python:
pip install blockfrost-python
5. Kiểm tra cài đặt (Hello World)
Để chắc chắn mọi thứ đã hoạt động trơn tru, hãy viết một đoạn code nhỏ để kiểm tra.
- Tạo file mới tên là test_setup.py.
- Nhập đoạn code sau:
import pycardano
from pycardano import Address, Network, PaymentVerificationKey, PaymentSigningKey
# Kiểm tra phiên bản
print(f”PyCardano Version: {pycardano.__version__}”)
# Thử tạo một cặp khóa (Key Pair) ngẫu nhiên
payment_signing_key = PaymentSigningKey.generate()
payment_verification_key = PaymentVerificationKey.from_signing_key(payment_signing_key)
# Tạo địa chỉ testnet từ khóa vừa tạo
address = Address(payment_part=payment_verification_key.hash(), network=Network.TESTNET)
print(“n— Setup Successful! —“)
print(f”Generated Testnet Address: {address}”)
- Chạy file bằng lệnh:
python test_setup.py
Nếu bạn thấy terminal in ra phiên bản PyCardano và một địa chỉ bắt đầu bằng addr_test…, xin chúc mừng! Bạn đã thiết lập thành công môi trường phát triển PyCardano trên Windows.
Tổng kết
Vậy là chúng ta đã hoàn thành các bước:
- Cài đặt Python (có PATH).
- Thiết lập VS Code.
- Tạo và kích hoạt môi trường ảo (venv).
- Cài đặt thư viện PyCardano.
Ở bài tiếp theo, đối với các bạn sử dụng Ubuntu và MacOS, mình cũng sẽ có các hướng dẫn riêng biệt tương tự. Hẹn gặp lại các bạn ở video kế tiếp!
Exercise Files
