CodeGym /Các khóa học /Python SELF VI /Dự án đầu tiên

Dự án đầu tiên

Python SELF VI

Mức độ , Bài học

Có sẵn

8.1 Phân tích cấu trúc IDE

Vậy là tụi mình đã tạo dự án mới. Giờ hãy xem kỹ coi có gì trong đây nhé.

1. Cây thư mục và file của dự án:

Nơi này cho thấy nội dung thư mục dự án của tụi mình — pythonProject.

2. File hiện tại đang mở:

Đây là nội dung file main.py, với cú pháp mã được làm nổi bật.

3. Phía trên là menu chính:

Các nút hữu ích ở góc phải trên:

«Tam giác xanh» — nút chạy dự án.
«Con bọ» — nút khởi động chế độ gỡ lỗi.
«Kính lúp» — tìm kiếm trong dự án.
«Bánh răng» — cài đặt.

4. Bên trái bạn thấy menu bên:

Ở đây có vài nút hữu ích, đặc biệt là nút Terminal.

5. Thanh trạng thái:

Bên trái thanh trạng thái hiển thị đường dẫn của file hiện tại đang mở. Bên phải là mã hóa của nó: CRLF, UTF-8.

Cực phải hiển thị phiên bản Python hiện tại — Python 3.12.x, mà dự án tụi mình đang dùng. Đôi khi nhìn vào đây cũng có ích, đặc biệt khi máy bạn cài nhiều phiên bản khác nhau của Python và có những dự án dùng các phiên bản khác nhau.

8.2 Phân tích dự án

Một dự án thông thường bao gồm các tệp được hiển thị trong bảng điều khiển bên trái. Các tệp này có thể được chia theo điều kiện thành 4 phần.

Các tệp mã Python. Các tệp như vậy có phần mở rộng .py và PyCharm đánh dấu chúng bằng biểu tượng màu xanh lam và vàng. Trong dự án của chúng ta hiện chỉ có một tệp như vậy — main.py

Các tệp tĩnh. Đây là tên gọi của các tệp chứa dữ liệu nhưng không phải mã. Đây có thể là tệp văn bản, hình ảnh, tệp phương tiện, v.v. Hiện tại không có tệp nào trong dự án của chúng ta.

Môi trường ảo Python. Trong thư mục có tên .venv (viết tắt của Virtual Environment) chứa các tệp Python, cũng như một số tiện ích dịch vụ. Trình quản lý gói pip cũng sẽ tải các thư viện của bên thứ ba mà bạn muốn sử dụng vào đây.

Thư viện của bên thứ ba (External libraries). Hiện tại không có thư viện nào trong dự án của chúng ta, nhưng khi bạn tải chúng xuống, PyCharm chắc chắn sẽ hiển thị chúng ở đây.

8.3 Môi trường ảo `.venv`

Hãy nói chi tiết hơn một chút về môi trường ảo. .venv là một mô-đun trong Python cung cấp khả năng tạo các môi trường ảo nhẹ và biệt lập khác nhau cho các dự án Python. Đây là một công cụ cho phép quản lý các phần phụ thuộc của dự án bằng cách tách biệt chúng khỏi các thư viện hệ thống. Hãy tưởng tượng rằng đây là một căn phòng biệt lập cho dự án của bạn, nơi nó có thể cất giữ đồ chơi và công cụ cá nhân của mình mà không làm phiền những cư dân khác trong nhà.

Về mặt kỹ thuật, nó hoạt động đơn giản: một bản sao của trình thông dịch Python và một nơi riêng biệt cho các thư viện được tạo bên trong thư mục dự án. Điều này đảm bảo rằng nếu bạn cài đặt một phiên bản cụ thể của thư viện cho một dự án, nó sẽ không làm hỏng một dự án khác cần phiên bản cũ hơn. Việc sử dụng môi trường ảo là một quy tắc ứng xử tốt giúp tránh khỏi xung đột phiên bản vô tận.

Quản lý môi trường trong PyCharm

PyCharm thường tự lo liệu việc này và tạo mọi thứ tự động. Nhưng đôi khi bạn vô tình xóa thư mục cần thiết hoặc chỉ muốn bắt đầu lại từ đầu. Biết cách quản lý các cài đặt này theo cách thủ công là một kỹ năng hữu ích.

Tạo môi trường

Ở góc dưới bên phải hiển thị trạng thái kết nối của ngôn ngữ Python. Nếu bạn thấy dòng chữ như Python 3.XX ở đó, nghĩa là quá trình cài đặt đã thành công. Môi trường phát triển nhìn thấy trình thông dịch và sẵn sàng thực hiện các lệnh của bạn.

Nếu ở đó viết No interpreter, hãy nhấp vào dòng chữ này.

Trong menu xuất hiện, chọn Add New Interpreter và sau đó Add Local Interpreter.
Trong cài đặt bên trái, chọn Environment. Ở giữa, hãy đảm bảo rằng hộp kiểm Generate New được chọn.
Nhấp OK. Trình chỉnh sửa sẽ tạo một thư mục .venv mới và ngay lập tức chuyển dự án sang thư mục đó. Bây giờ bạn có một hệ thống hoàn toàn sạch sẽ mà không có rác thừa.

Xóa cái cũ hoặc thừa

Đôi khi các thử nghiệm đi vào ngõ cụt và việc xóa môi trường dễ dàng hơn là cố gắng sửa nó. Đây là cách thực hiện:

Nhấp lại vào phiên bản Python ở góc dưới bên phải và chọn mục Interpreter Settings.
Ở trên cùng, tìm trường Python Interpreter. Mở rộng danh sách và chọn mục Show All.
Bạn sẽ thấy danh sách tất cả các môi trường mà PyCharm biết. Chọn môi trường bạn muốn xóa và nhấp vào nút có dấu trừ trong menu phía trên danh sách.
Một điểm quan trọng: PyCharm sẽ chỉ đơn giản là "quên" môi trường này và ngừng sử dụng nó. Để giải phóng dung lượng ổ đĩa về mặt vật lý, bạn cần vào thư mục dự án thông qua trình khám phá tệp thông thường và xóa thủ công thư mục .venv.

Tạo môi trường thứ hai

Lỗi: «Already contains Python»

Nếu bạn vào menu thêm trình thông dịch và chọn Generate new, PyCharm có thể hiển thị cảnh báo màu đỏ và chặn nút OK. Điều này xảy ra vì trình chỉnh sửa theo thói quen cố gắng tạo một môi trường mới trong cùng một thư mục .venv đã bị chiếm bởi môi trường đầu tiên của bạn. Hai bộ thư viện khác nhau không thể sống trong cùng một thư mục.

Cách khắc phục điều này

Chỉ cần đặt cho "hộp cát" mới một cái tên duy nhất. Đây là cách thực hiện:

Mở menu Add Local Interpreter, như chúng ta đã làm trước đây.
Chọn mục Generate new.
Nhìn vào trường Location. Rất có thể, đường dẫn ở đó kết thúc bằng tên tiêu chuẩn \.venv.
Đặt con trỏ vào cuối dòng và chỉ cần thêm bất kỳ chữ số nào vào đó. Thay đổi phần cuối của đường dẫn thành \.venv_2 và nhấn Enter.
Dòng chữ màu đỏ sẽ biến mất ngay lập tức. Nhấn OK.

Bây giờ trong dự án của bạn sẽ tồn tại vật lý hai thư mục khác nhau với các cài đặt và PyCharm sẽ tự động chuyển sang phiên bản mới.

Cách chuyển đổi giữa các môi trường

Khả năng tung hứng với các môi trường là một kỹ năng quan trọng. Nhưng có một mánh khóe ở đây: PyCharm không phải lúc nào cũng tự động nhớ các môi trường cũ của bạn.

Thường xảy ra trường hợp bạn đã tạo môi trường thứ hai và môi trường thứ nhất biến mất khỏi menu, mặc dù thư mục .venv vẫn nằm trong dự án. Trong trường hợp này, bạn chỉ cần chỉ cho PyCharm nơi tìm Python cũ. Ví dụ để chuyển từ .venv_2 sang .venv:

Nhấp vào phiên bản Python ở góc và chọn Add New Interpreter -> Add Local Interpreter.
Trong cửa sổ xuất hiện, chuyển dấu chấm sang mục Select Existing.
Trong trường Python Path, nhấp vào biểu tượng thư mục ở bên phải.
Bây giờ bạn cần tìm tệp khởi chạy Python trong thư mục cũ của bạn (.venv). Đi theo đường dẫn: Dự_án_của_bạn -> .venv -> Scripts (đối với Windows) hoặc bin (đối với macOS/Linux).
Bên trong thư mục này, chọn tệp python và nhấn OK.

Bây giờ môi trường cũ sẽ xuất hiện lại trong phần cài đặt và trở nên hoạt động. Phương pháp này hoạt động hoàn hảo, ngay cả khi PyCharm "quên" cài đặt của bạn.

8.4 Làm việc với terminal

Trong PyCharm bạn có thể làm việc với dòng lệnh của hệ điều hành một cách trực tiếp. Trên Linux và MacOS, dòng lệnh thường được gọi là Terminal, vì thế trong PyCharm nó cũng được gọi như vậy. Thực ra cũng không phải do PyCharm tự đặt đâu, tên gọi này rất quen thuộc với lập trình viên rồi.

Để mở Terminal bạn cần nhấn vào nút terminal trong menu bên: