Đường dẫn thư viện Python macos
Bài viết này thảo luận về các tính năng môi trường Python hữu ích có sẵn trong Visual Studio Code. Một "môi trường" trong Python là ngữ cảnh trong đó chương trình Python chạy và bao gồm một trình thông dịch và bất kỳ số lượng gói đã cài đặt nào Show
Môi trường PythonMôi trường toàn cầuTheo mặc định, bất kỳ trình thông dịch Python nào được cài đặt đều chạy trong môi trường chung của chính nó. Chúng không dành riêng cho một dự án cụ thể. Ví dụ: nếu bạn chỉ chạy 2, 3 hoặc 4 tại một thiết bị đầu cuối mới (tùy thuộc vào cách bạn cài đặt Python), thì bạn đang chạy trong môi trường chung của trình thông dịch đó. Bất kỳ gói nào bạn cài đặt hoặc gỡ cài đặt đều ảnh hưởng đến môi trường chung và tất cả các chương trình bạn chạy trong đóLàm việc trong môi trường toàn cầu là một cách dễ dàng để bắt đầu. Tuy nhiên, nếu bạn cài đặt các gói trong môi trường đó, theo thời gian, nó sẽ trở nên đông đúc và gây khó khăn cho việc kiểm tra ứng dụng đúng cách môi trường ảoĐể tránh sự lộn xộn như vậy, các nhà phát triển thường tạo một môi trường ảo cho một dự án. Môi trường ảo là một thư mục chứa bản sao (hoặc liên kết tượng trưng) của một trình thông dịch cụ thể. Khi bạn cài đặt vào môi trường ảo, bất kỳ gói nào bạn cài đặt chỉ được cài đặt trong thư mục con đó. Sau đó, khi bạn chạy một chương trình Python trong môi trường đó, bạn biết rằng nó chỉ chạy với các gói cụ thể đó
Công cụ môi trường PythonKhi bạn kích hoạt môi trường ảo của mình, bạn sẽ cần xác định cách quản lý môi trường đó và các gói đi kèm của nó. Bảng sau giải thích cách sử dụng các môi trường Python này ToolDefinition và PurposepipTrình quản lý gói Python cài đặt và cập nhật các gói. Nó được cài đặt với Python 3. 9+ theo mặc định (cài đặt 5 trên hệ điều hành dựa trên Debian). venvCho phép bạn quản lý cài đặt gói riêng biệt cho các dự án khác nhau và được cài đặt với Python 3 theo mặc định (cài đặt 6 nếu bạn đang sử dụng HĐH dựa trên Debian)condaĐược cài đặt với Anaconda và Miniconda. Nó có thể được sử dụng để quản lý cả gói và môi trường ảo. Thường được sử dụng cho các dự án khoa học dữ liệumôi trường condaMôi trường conda là môi trường Python được quản lý bằng trình quản lý gói 7 (xem Bắt đầu với conda (conda. io)). Việc sử dụng môi trường chung cư hay môi trường ảo sẽ phụ thuộc vào nhu cầu đóng gói của bạn, nhóm của bạn đã chuẩn hóa những gì, v.v.Nơi tiện ích tìm kiếm môi trườngTiện ích mở rộng tự động tìm thông dịch viên ở các vị trí sau
Bạn cũng có thể chỉ định trình thông dịch theo cách thủ công nếu Visual Studio Code không tự động định vị trình thông dịch của bạn
Tiện ích mở rộng cũng tải tệp định nghĩa biến môi trường được xác định bởi cài đặt 9. Giá trị mặc định của cài đặt này là 80Tạo môi trườngSử dụng lệnh Tạo môi trườngTừ trong Mã VS, bạn có thể tạo các môi trường không toàn cục, sử dụng môi trường ảo hoặc Anaconda, bằng cách mở Bảng lệnh ( ⇧⌘P (Windows, Linux Ctrl+Shift+P)), start typing the Python: Create Environment command to search, and then select the command. Lệnh trình bày một danh sách các loại môi trường. Venv hoặc Conda Nếu bạn đang tạo một môi trường bằng Venv, lệnh sẽ hiển thị danh sách các trình thông dịch có thể được sử dụng làm cơ sở cho môi trường ảo mới Nếu bạn đang tạo một môi trường bằng Conda, lệnh sẽ hiển thị danh sách các phiên bản Python có thể được sử dụng cho dự án của bạn Sau khi chọn phiên bản Python hoặc trình thông dịch mong muốn, một thông báo sẽ hiển thị tiến trình tạo môi trường và thư mục môi trường sẽ xuất hiện trong không gian làm việc của bạn
Tạo một môi trường ảo trong thiết bị đầu cuốiĐể tạo một môi trường ảo, hãy sử dụng lệnh sau, trong đó ". venv" là tên của thư mục môi trường 2
Khi bạn tạo một môi trường ảo mới, một lời nhắc sẽ được hiển thị để cho phép bạn chọn nó cho không gian làm việc Thao tác này sẽ thêm đường dẫn đến trình thông dịch Python từ môi trường ảo mới vào cài đặt không gian làm việc của bạn. Môi trường đó sau đó sẽ được sử dụng khi cài đặt các gói và chạy mã thông qua tiện ích mở rộng Python. Để biết ví dụ về cách sử dụng môi trường ảo trong các dự án, hãy xem hướng dẫn về Python, Django và Flask
Tạo một môi trường conda trong thiết bị đầu cuốiTiện ích mở rộng Python tự động phát hiện các môi trường conda hiện có. Chúng tôi khuyên bạn nên cài đặt trình thông dịch Python vào môi trường conda của mình, nếu không, một trình thông dịch sẽ được cài đặt cho bạn sau khi bạn chọn môi trường. Ví dụ: lệnh sau tạo môi trường conda với Python 3. 9 và một số thư viện, VS Code sau đó hiển thị trong danh sách các trình thông dịch có sẵn
Ngược lại, nếu bạn không chỉ định trình thông dịch, chẳng hạn như với 00, môi trường sẽ không xuất hiện trong danh sáchĐể biết thêm thông tin về dòng lệnh conda, hãy xem Môi trường conda (conda. i) Ghi chú bổ sung
Làm việc với trình thông dịch PythonChọn và kích hoạt một môi trườngTheo mặc định, tiện ích mở rộng Python tìm kiếm và sử dụng trình thông dịch Python đầu tiên mà nó tìm thấy trong đường dẫn hệ thống. Để chọn một môi trường cụ thể, hãy sử dụng Python. Chọn lệnh Thông dịch từ Bảng lệnh ( ⇧⌘P (Windows, Linux Ctrl+Shift+P)).
Bạn có thể chuyển đổi môi trường bất cứ lúc nào; con trăn. Chọn lệnh Phiên dịch hiển thị danh sách các môi trường toàn cầu, môi trường conda và môi trường ảo có sẵn. (Xem phần Nơi tiện ích tìm kiếm môi trường để biết chi tiết, bao gồm sự khác biệt giữa các loại môi trường này. ) Ví dụ: hình ảnh sau đây hiển thị một số bản cài đặt Anaconda và CPython cùng với môi trường conda và môi trường ảo ( 05) nằm trong thư mục không gian làm việc
Nếu bạn có một thư mục hoặc không gian làm việc đang mở trong Mã VS và bạn chọn một trình thông dịch từ danh sách, tiện ích mở rộng Python sẽ lưu trữ thông tin đó bên trong để cùng một trình thông dịch sẽ được sử dụng khi bạn mở lại không gian làm việc Tiện ích mở rộng Python sử dụng môi trường đã chọn để chạy mã Python (sử dụng Python. Chạy tệp Python trong lệnh Terminal), cung cấp các dịch vụ ngôn ngữ (tự động hoàn thành, kiểm tra cú pháp, linting, định dạng, v.v. ) khi bạn mở tệp 06 trong trình chỉnh sửa và mở một thiết bị đầu cuối bằng Terminal. Tạo lệnh Terminal mới. Trong trường hợp sau, Mã VS tự động kích hoạt môi trường đã chọn
Phiên bản trình thông dịch đã chọn sẽ hiển thị ở bên phải của Thanh trạng thái Thanh trạng thái cũng phản ánh khi không có trình thông dịch nào được chọn Trong cả hai trường hợp, nhấp vào khu vực này của Thanh trạng thái là một lối tắt thuận tiện cho Python. Chọn lệnh Thông dịch viên
Chỉ định trình thông dịch theo cách thủ côngNếu Mã VS không tự động định vị trình thông dịch mà bạn muốn sử dụng, bạn có thể duyệt tìm trình thông dịch trên hệ thống tệp của mình hoặc cung cấp đường dẫn đến trình thông dịch đó theo cách thủ công Bạn có thể làm như vậy bằng cách chạy Python. Chọn lệnh Thông dịch viên và nhấp vào đường dẫn Nhập thông dịch viên. tùy chọn hiển thị trên đầu danh sách trình thông dịch Sau đó, bạn có thể nhập trực tiếp đường dẫn đầy đủ của trình thông dịch Python vào hộp văn bản (ví dụ: ". venv/Tập lệnh/trăn. exe") hoặc bạn có thể chọn Tìm. và duyệt qua hệ thống tệp của bạn để tìm tệp thực thi python mà bạn muốn chọn Nếu bạn muốn chỉ định thủ công trình thông dịch mặc định sẽ được sử dụng khi bạn mở không gian làm việc lần đầu tiên, bạn có thể tạo hoặc sửa đổi mục nhập cho cài đặt 11 trong không gian làm việc của bạn 08 với đường dẫn đầy đủ đến tệp thực thi PythonVí dụ
Bạn cũng có thể sử dụng 11 để trỏ đến một môi trường ảo chẳng hạn
Ngoài ra, nếu bạn muốn thiết lập trình thông dịch mặc định cho tất cả các ứng dụng Python của mình, bạn có thể thêm mục nhập cho 11 theo cách thủ công bên trong Cài đặt người dùng của mình. Để làm như vậy, hãy mở Bảng lệnh ( ⇧⌘P (Windows, Linux Ctrl+Shift+P)) and enter Preferences: Open User Settings. Then set 11, which is in the Python extension section of User Settings, with the appropriate interpreter.Bạn cũng có thể sử dụng biến môi trường trong cài đặt đường dẫn bằng cú pháp 17. Ví dụ: nếu bạn đã tạo một biến có tên 18 với đường dẫn đến trình thông dịch, thì bạn có thể sử dụng giá trị cài đặt sau 3
Bằng cách sử dụng biến môi trường, bạn có thể dễ dàng chuyển dự án giữa các hệ điều hành có đường dẫn khác nhau, chỉ cần đảm bảo đặt biến môi trường trên hệ điều hành trước Môi trường và cửa sổ TerminalSau khi sử dụng Python. Chọn Trình thông dịch, trình thông dịch đó được áp dụng khi nhấp chuột phải vào tệp và chọn Python. Chạy tệp Python trong Terminal. Môi trường cũng được kích hoạt tự động khi bạn sử dụng Terminal. Tạo lệnh Terminal mới trừ khi bạn thay đổi cài đặt 30 thành 31Tuy nhiên, khởi chạy Mã VS từ trình bao trong đó một môi trường Python nhất định được kích hoạt sẽ không tự động kích hoạt môi trường đó trong Thiết bị đầu cuối tích hợp mặc định. Sử dụng thiết bị đầu cuối. Tạo lệnh Terminal mới sau khi Mã VS đang chạy
Mọi thay đổi bạn thực hiện đối với môi trường được kích hoạt trong thiết bị đầu cuối đều được duy trì. Ví dụ: sử dụng 32 từ thiết bị đầu cuối với môi trường conda được kích hoạt sẽ cài đặt gói vĩnh viễn vào môi trường đó. Tương tự, sử dụng 33 trong thiết bị đầu cuối có môi trường ảo được kích hoạt sẽ thêm gói vào môi trường đóThay đổi trình thông dịch bằng Python. Chọn lệnh Phiên dịch không ảnh hưởng đến bảng điều khiển đầu cuối đã được mở. Do đó, bạn có thể kích hoạt các môi trường riêng biệt trong một thiết bị đầu cuối phân chia. chọn trình thông dịch đầu tiên, tạo một thiết bị đầu cuối cho nó, chọn một trình thông dịch khác, sau đó sử dụng nút tách ( ⌘\ (Windows, Linux Ctrl+Shift+5)) in the terminal title bar. Chọn một môi trường gỡ lỗiTheo mặc định, trình gỡ lỗi sẽ sử dụng trình thông dịch Python mà bạn đã chọn với phần mở rộng Python. Tuy nhiên, nếu bạn có thuộc tính 2 trong cấu hình gỡ lỗi của 35, thì trình thông dịch đó sẽ được sử dụng thay thế. Để cụ thể hơn, Mã VS sẽ ưu tiên cho thuộc tính 2 của cấu hình gỡ lỗi đã chọn trong 35. Nếu nó không được xác định thì nó sẽ sử dụng đường dẫn đến trình thông dịch Python mà bạn đã chọn cho không gian làm việc của mìnhĐể biết thêm chi tiết về cấu hình gỡ lỗi, hãy xem Cấu hình gỡ lỗi Hỗ trợ hạn chế cho Python 2. 7Tiện ích mở rộng Python không còn cung cấp hỗ trợ IntelliSense cho Python 2. 7 với Jedi vì nó chỉ hỗ trợ Python 3 vào thời điểm này. Khi sử dụng Python 2. 7 với tiện ích mở rộng Python, bạn có thể tùy chỉnh cài đặt máy chủ ngôn ngữ để tắt tính năng tự động hoàn thành hoặc chọn Pylance làm máy chủ ngôn ngữ của mình, vì nó có thể mang lại trải nghiệm tốt nếu mã đủ tương thích với Python 3 Chúng tôi hiện hỗ trợ chọn Python 2. 7 làm thông dịch viên trong không gian làm việc của bạn. Bởi vì Python 2. 7 không còn được duy trì kể từ tháng 1 năm 2020, chúng tôi thực sự khuyên bạn nên nâng cấp mã của mình lên Python 3 ngay khi có thể. Bạn có thể tìm hiểu cách chuyển mã của mình sang Python 3 nếu cần trợ giúp Biến môi trườngTệp định nghĩa biến môi trườngTệp định nghĩa biến môi trường là một tệp văn bản đơn giản chứa các cặp khóa-giá trị ở dạng 38, với 39 được sử dụng để nhận xét. Giá trị nhiều dòng không được hỗ trợ nhưng giá trị có thể tham chiếu đến bất kỳ biến môi trường nào khác đã được xác định trong hệ thống hoặc trước đó trong tệp. Để biết thêm thông tin, hãy xem Thay thế biến. Các tệp định nghĩa biến môi trường có thể được sử dụng cho các tình huống như gỡ lỗi và thực thi công cụ (bao gồm cả linters, formatters, IntelliSense và các công cụ kiểm tra), nhưng không được áp dụng cho thiết bị đầu cuốiTheo mặc định, tiện ích mở rộng Python tìm và tải tệp có tên 19 trong thư mục không gian làm việc hiện tại, sau đó áp dụng các định nghĩa đó. Tệp được xác định bằng mục nhập mặc định 61 trong cài đặt người dùng của bạn (xem Cài đặt Python chung). Bạn có thể thay đổi cài đặt 9 bất kỳ lúc nào để sử dụng tệp định nghĩa khác
Cấu hình gỡ lỗi cũng chứa thuộc tính 63 cũng được đặt mặc định cho tệp 19 trong không gian làm việc hiện tại (xem Gỡ lỗi - Đặt tùy chọn cấu hình). Thuộc tính này cho phép bạn dễ dàng đặt các biến cho mục đích gỡ lỗi thay thế các biến được chỉ định trong tệp 19 mặc địnhVí dụ: khi phát triển ứng dụng web, bạn có thể muốn dễ dàng chuyển đổi giữa máy chủ phát triển và máy chủ sản xuất. Thay vì mã hóa trực tiếp các URL khác nhau và các cài đặt khác vào ứng dụng của bạn, bạn có thể sử dụng các tệp định nghĩa riêng cho từng. Ví dụ nhà phát triển. tập tin env 6sản xuất. tập tin env 2Sau đó, bạn có thể đặt cài đặt 9 thành 67, sau đó đặt thuộc tính 63 trong cấu hình gỡ lỗi thành 69
thay thế biếnKhi xác định biến môi trường trong tệp định nghĩa, bạn có thể sử dụng giá trị của bất kỳ biến môi trường hiện có nào theo cú pháp chung sau 5trong đó 28 có nghĩa là bất kỳ văn bản nào khác được sử dụng trong giá trị. Các dấu ngoặc nhọn được yêu cầuTrong cú pháp này, các quy tắc sau được áp dụng
Sử dụng biến PYTHONPATHBiến môi trường PYTHONPATH chỉ định các vị trí bổ sung mà trình thông dịch Python sẽ tìm kiếm các mô-đun. Trong Mã VS, PYTHONPATH có thể được đặt thông qua cài đặt thiết bị đầu cuối (thiết bị đầu cuối. tích hợp. env. *) và/hoặc trong tệp 19Khi cài đặt thiết bị đầu cuối được sử dụng, PYTHONPATH sẽ ảnh hưởng đến bất kỳ công cụ nào được người dùng chạy trong thiết bị đầu cuối, cũng như mọi hành động mà tiện ích mở rộng thực hiện cho người dùng được định tuyến qua thiết bị đầu cuối, chẳng hạn như gỡ lỗi. Tuy nhiên, trong trường hợp này khi tiện ích mở rộng đang thực hiện một hành động không được định tuyến qua thiết bị đầu cuối, chẳng hạn như sử dụng trình nói dối hoặc trình định dạng, thì cài đặt này sẽ không ảnh hưởng đến việc tra cứu mô-đun Khi PYTHONPATH được đặt bằng tệp 19, nó sẽ ảnh hưởng đến mọi thứ mà tiện ích mở rộng thực hiện thay cho bạn và các hành động do trình gỡ lỗi thực hiện, nhưng nó sẽ không ảnh hưởng đến các công cụ chạy trong thiết bị đầu cuốiNếu cần, bạn có thể đặt PYTHONPATH bằng cả hai phương pháp Một ví dụ về thời điểm sử dụng PYTHONPATH là nếu bạn có mã nguồn trong thư mục 02 và kiểm tra trong thư mục 03. Tuy nhiên, khi chạy thử nghiệm, các thử nghiệm đó thường không thể truy cập các mô-đun trong 02 trừ khi bạn mã hóa cứng các đường dẫn tương đốiĐể giải quyết vấn đề này, bạn có thể thêm đường dẫn đến 02 vào PYTHONPATH bằng cách tạo tệp 19 trong không gian làm việc Mã VS của bạn 0Sau đó, đặt 9 trong tệp 08 của bạn để trỏ đến tệp 19 bạn vừa tạo. Ví dụ: nếu tệp 19 nằm trong thư mục gốc không gian làm việc của bạn, thì 08 của bạn sẽ được đặt như được hiển thị 1Giá trị của PYTHONPATH có thể chứa nhiều vị trí cách nhau bởi 12. dấu chấm phẩy ( 13) trên Windows và dấu hai chấm ( 14) trên Linux/macOS. Đường dẫn không hợp lệ bị bỏ qua. Nếu bạn thấy rằng giá trị của mình cho PYTHONPATH không hoạt động như mong đợi, hãy đảm bảo rằng bạn đang sử dụng đúng dấu phân cách giữa các vị trí cho hệ điều hành. Ví dụ: sử dụng dấu hai chấm để phân tách các vị trí trên Windows hoặc sử dụng dấu chấm phẩy để phân tách các vị trí trên Linux/macOS dẫn đến giá trị không hợp lệ cho PYTHONPATH, giá trị này sẽ bị bỏ qua
|