Hướng dẫn how to run python github project - cách chạy dự án github python

python-on-windows

Hướng dẫn từng bước về cài đặt Python và sử dụng dấu nhắc lệnh cho Windows

• Phiên bản: 1.1.0
• Ngày: 2017-01-03
• Tác giả: Alberto Pettarin (Liên hệ)
• Giấy phép: Creative Commons Attribution 4.0 International (CC by 4.0)

Tổng quan

Bạn có muốn chạy một chương trình Python trong Windows, nhưng bạn không có kinh nghiệm sử dụng dấu nhắc lệnh?

Hướng dẫn này là dành cho bạn!

Tôi sẽ hướng dẫn bạn thông qua việc cài đặt Python và tôi sẽ giải thích những điều cơ bản của dấu nhắc lệnh.installation of Python and I will explain the basics of the Command Prompt.

Sau khi đọc trang này (và thực hành một chút), bạn sẽ có thể chạy một chương trình Python một cách tự tin và an toàn.run a Python program confidently and safely.

Python là gì?

Python là một ngôn ngữ lập trình cấp cao, cấp cao, cho phép mọi người dễ dàng tạo và chia sẻ các chương trình cho nhiều ứng dụng.programming language which allows people to easily create and share programs for a variety of applications.

Dự án Python là một sáng kiến ​​phần mềm miễn phí (Libre)/nguồn mở (Floss), được quản lý bởi Quỹ phần mềm Python. Bạn có thể tải xuống, cài đặt và sử dụng Python miễn phí trên một số nền tảng, bao gồm Linux, Mac OS X và máy tính Windows.for free on several platforms, including Linux, Mac OS X, and Windows computers.

Python cho phép phát triển các chương trình Floss, được tạo ra miễn phí bởi hàng triệu tình nguyện viên trên toàn cầu và được chia sẻ ở dạng mã nguồn. Điều này có nghĩa là người dùng cuối nhận hoặc tải xuống chương trình Python thực sự có thể kiểm tra xem chương trình có phải làm gì không và không có gì hơn (không giống như các chương trình nguồn đóng, gửi thông tin cá nhân cho bên thứ ba, hiển thị cho bạn quảng cáo hoặc thiệt hại máy tính của bạn).source code form. This means that the end user who receives or downloads a Python program can actually check that the program does what is supposed to do, and nothing more (unlike closed-source programs, which send personal information to third parties, show you advertisements, or damage your computer).

Thông tin chi tiết về Python có thể được tìm thấy trên trang Python chính thức và trên trang Wikipedia của nó.

Trong thực tế, để sử dụng chương trình Python, bạn cần hai phần mềm:

• Trình thông dịch Python, là chương trình "chính" đọc mã nguồn của chương trình Python và "thực thi" nó; vàPython interpreter, which is the "master" program that reads the source code of a Python program, and "execute" it; and
• Mã nguồn của chương trình Python, thường bao gồm một hoặc nhiều tệp có tiện ích mở rộng .py, thực hiện nhiệm vụ cụ thể mà bạn quan tâm.source code of the Python program, usually consisting of one or more files with .py extension, which performs the specific task you are interested in.

Hướng dẫn này giải thích cách cài đặt cái trước và nó chỉ ra cách chạy cái sau trong lời nhắc lệnh của Windows, với một ví dụ hoàn chỉnh, thực tế.

Cài đặt Python trên Windows

Bước sơ bộ bao gồm cài đặt trình thông dịch Python (tức là "chương trình chính") trên máy tính của bạn.

Cài đặt Python là một hoạt động một lần. Nếu bạn đã cài đặt Python trong quá khứ (ví dụ: để chạy một chương trình khác), bạn không cần phải cài đặt lại và bạn có thể bỏ qua phần tiếp theo. If you already installed Python in the past (for example, to run a different program), you do not need to install it again, and you can skip to the next section.

Bước 0: Tôi nên lấy Python 2 hay Python 3?

Tại thời điểm viết (2017-01-01), có hai phiên bản chính của Python: Python 2 (2.7.13) và Python 3 (3.6.0).Python 2 (2.7.13) and Python 3 (3.6.0).

Thảo luận về sự khác biệt kỹ thuật giữa hai phiên bản này nằm ngoài phạm vi của hướng dẫn này. Nó đủ để nói rằng một số chương trình Python hoạt động với cả hai phiên bản Python, trong khi các chương trình Python khác chỉ hoạt động với Python 2 nhưng không phải với Python 3, hoặc ngược lại.

Bạn nên có được phiên bản Python mà chương trình bạn quan tâm đến khuyến nghị. Nếu phiên bản sau không chỉ định phiên bản, hãy có sẵn phiên bản Python 3 mới nhất. Nếu sau đó bạn phát hiện ra rằng chương trình Python của bạn không hoạt động với phiên bản Python bạn đã cài đặt, đừng lo lắng: Chỉ cần gỡ cài đặt nó và cài đặt chương trình khác! If the latter does not specify a version, get the latest Python 3 version available. If you later discover that your Python program does not work with the Python version you installed, do not worry: just uninstall it, and install the other one!

Trong phần còn lại của hướng dẫn, chúng tôi cho rằng bạn cần Python 3.Python 3.

Bước 1: Tải xuống trình cài đặt

Trước tiên, hãy mở trình duyệt web của bạn và truy cập https://python.org/:

Nhấp vào Tải xuống> Liên kết Python 3.6.0 mới nhất.Download > Latest Python 3.6.0 link.

Bạn sẽ nhận được một trang danh sách tất cả các tính năng mới của Python 3.6.0:

Cuộn xuống cho đến khi bạn thấy danh sách các bản tải xuống có sẵn:

Nếu bạn có một máy tính Windows gần đây, rất có thể đó là một máy 64 bit, vì vậy bạn nên tải xuống tệp có nhãn Windows X86-64 và lưu nó trên thư mục tải xuống hoặc trên máy tính để bàn của bạn:Windows x86-64 executable installer, and save it on your Download folder or on your Desktop:

Tải xuống tệp sẽ mất từ ​​vài giây xuống vài phút, tùy thuộc vào băng thông của kết nối internet của bạn.

. Bảng điều khiển.)Windows x86 executable installer instead. You can tell whether your PC is a 32-bit or a 64-bit machine by reading the System Information in the Windows Control Panel.)

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

Bấm đúp vào tệp bạn vừa tải xuống để bắt đầu Trình hướng dẫn cài đặt:

Theo mặc định, tùy chọn Thêm Python 3.6 vào đường dẫn bị vô hiệu hóa, nhưng bạn nên chọn nó, vì nó giúp chạy các chương trình Python dễ dàng hơn nhiều.Add Python 3.6 to PATH option is disabled, but you should select it, as it makes running Python programs much much easier.

Hầu hết người dùng nên nhấp vào nút Cài đặt ngay bây giờ, cài đặt Python với các cài đặt mặc định. (Nếu bạn muốn cá nhân hóa cài đặt của mình hoặc bạn được yêu cầu bật một số tính năng nâng cao, hãy nhấp vào tùy chọn Cài đặt tùy chỉnh thay thế.)Install Now button, which installs Python with the default settings. (If you want to personalize your installation or you are told to enable some advanced features, click on the Customize installation option instead.)

Trình cài đặt có thể yêu cầu bạn cho các đặc quyền quản trị hoặc để xác nhận như sau:

Bạn có thể trả lời một cách an toàn có.Yes.

Một thanh tiến độ sẽ xuất hiện:

Cho đến khi cài đặt hoàn thành với thông báo sau:

Bắt đầu với Python 3.6.0, nên nhấp vào tùy chọn giới hạn độ dài đường dẫn vô hiệu hóa, trước khi đóng trình cài đặt. Nếu bạn làm như vậy, bạn sẽ nhận được hộp thoại xác nhận cuối cùng:Disable path length limit option, before closing the installer. If you do so, you will get a final confirmation dialog:

Bạn có thể chấm dứt cài đặt bằng cách nhấp vào nút Đóng.Close button.

Xin chúc mừng, bạn có cài đặt Python đầu tiên của bạn trong vành đai của bạn!your first Python installation under your belt!

Sử dụng dấu nhắc lệnh

Hầu hết các chương trình Python là các tiện ích giao diện dòng lệnh (CLI), có nghĩa là chúng không được vận hành thông qua giao diện người dùng đồ họa (GUI), còn được gọi là "cửa sổ chương trình". Thay vào đó, chúng phải được thực thi trong lời nhắc lệnh của Windows, còn được gọi là "shell" hoặc "thiết bị đầu cuối".Command Prompt of Windows, also known as "shell" or "terminal".

Chạy chương trình CLI có nghĩa là gõ một chuỗi lệnh trên dấu nhắc lệnh của Windows, theo một cú pháp nhất định phụ thuộc vào những gì chương trình được cho là sẽ làm. Bạn có thể nghĩ về hành động này là đọc "Phép thuật đúng" để hoàn thành công việc của bạn.typing a command string on the Command Prompt of Windows, following a certain syntax which depends on what the program is supposed to do. You can think of this act as reciting the "right spell" to get your job done.

Mở dấu nhắc lệnh

Để mở dấu nhắc lệnh, hãy xác định vị trí biểu tượng nhắc lệnh trong menu Bắt đầu của bạn (hoặc sử dụng thanh tìm kiếm):

Nhấp vào biểu tượng. Một cửa sổ màu đen xuất hiện:

Hai dòng đầu tiên được in trong cửa sổ hiển thị phiên bản của dấu nhắc lệnh. Dòng cuối cùng, đọc C:\Users\IEUser> trong ảnh chụp màn hình ở trên, là lời nhắc, nơi bạn thực sự có thể nhập các lệnh.prompt, where you can actually type commands.

Dòng nhắc nhở luôn bắt đầu với vị trí của thư mục làm việc, nghĩa là thư mục mà dấu nhắc lệnh hiện đang hoạt động (C:\Users\IEUser trong ảnh chụp màn hình ở trên) và kết thúc bằng ký tự >.working directory, that is, the folder where the command prompt is currently acting upon (C:\Users\IEUser in the screenshot above), and ends with the > character.

Lời nhắc thường mở trong thư mục nhà của người dùng hiện tại: Trên thực tế, chúng tôi đang ở C:\Users\IEUser, vì người dùng được gọi là IEUser. Nếu tên người dùng Windows của bạn là Olga, có khả năng bạn sẽ thấy C:\Users\Olga thay thế.home directory of the current user: in fact, we are in C:\Users\IEUser, because the user is called IEUser. If your Windows username is Olga, it is likely you will see C:\Users\Olga instead.

(Các phiên bản khác nhau của Windows có thể có các đường dẫn khác nhau cho các thư mục nhà.)

Trong tài liệu của các chương trình Python, bạn có thể tìm thấy một ký tự ____10 trước các ví dụ về các lệnh, như sau:

$ python my_awesome_program.py

Bởi vì trên máy Linux và Mac OS X, dấu nhắc đầu cuối thường là ký tự

C:\Users\IEUser> python my_awesome_program.py

Bạn không nên gõ ký tự

C:\Users\IEUser> python my_awesome_program.py

C:\Users\IEUser> python my_awesome_program.py

C:\Users\IEUser> python my_awesome_program.py

C:\Users\IEUser> python my_awesome_program.py

C:\Users\IEUser> python my_awesome_program.py

(Bạn thực sự sẽ chỉ nhập

C:\Users\IEUser> python my_awesome_program.py

Ba quy tắc an toàn

Bằng cách phát hành các lệnh trên dấu nhắc lệnh, bạn có thể vô tình xóa các tệp hoặc cửa sổ của riêng mình, vì vậy bạn phải cẩn thận.accidentally delete your own files or damage Windows, so you must be careful.

Đừng sợ hãi hoặc nản lòng: Bạn không ngừng sử dụng dao chỉ vì bạn có thể cắt ngón tay của mình với chúng!

Bằng cách tuân theo ba quy tắc an toàn, bạn có thể vận hành nhanh chóng một cách an toàn:Three Safety Rules, you can operate the prompt safely:

1. Không bao giờ đưa ra lệnh mà không hiểu những gì nó làm và chỉ chạy các chương trình thu được từ các nhà phát triển mà bạn tin tưởng.
2. Nếu bất cứ điều gì xảy ra trong lời nhắc mà bạn không hiểu, bạn chỉ cần nhấp vào "X" ở góc trên cùng bên phải để đóng cửa sổ nhắc lệnh (và hy vọng sẽ không có gì xấu sẽ xảy ra với các tệp của bạn).
3. Luôn sao chép chương trình Python của bạn trong một thư mục riêng và luôn tạo các bản sao của các tệp đầu vào của bạn trong đó, để bạn có thể vứt bỏ thư mục chương trình Python nếu có sự cố và bắt đầu lại.

Thay đổi thư mục làm việc (C:\Users\IEUser> python my_awesome_program.py 6)

Như đã nói ở trên, lời nhắc lệnh thường mở trong thư mục nhà của người dùng của bạn:

Nếu bạn muốn thay đổi thư mục làm việc hiện tại, bạn có thể sử dụng lệnh

C:\Users\IEUser> python my_awesome_program.py

C:\Users\IEUser> python my_awesome_program.py

C:\Users\IEUser> python my_awesome_program.py

Lưu ý rằng lời nhắc đã thay đổi thành .py1.

Liệt kê nội dung của thư mục làm việc (.py2)

Nếu bạn muốn một danh sách các tệp hoặc thư mục con có trong thư mục làm việc hiện tại, hãy đưa ra lệnh .py2, không có đối số:

Lời nhắc hiển thị danh sách các thư mục và tệp có trong ổ

C:\Users\IEUser> python my_awesome_program.py

Tại thời điểm này, nếu bạn muốn nhập thư mục .py8, bạn chỉ cần nhập .py9, v.v.

Nếu bạn muốn đi lên một cấp độ, hãy loại C:\Users\IEUser>0 (hai ký tự dừng đầy đủ). Ví dụ: nếu bạn đang ở trong C:\Users\IEUser>1 và cho C:\Users\IEUser>0, bạn sẽ kết thúc vào

C:\Users\IEUser> python my_awesome_program.py

Nếu bạn muốn xóa cửa sổ nhắc, hãy sử dụng lệnh C:\Users\IEUser>4.

Kiểm tra xem Python có được cài đặt đúng không

Nếu bạn đã chọn tùy chọn Thêm Python vào đường dẫn, bạn có thể chạy trình thông dịch Python (và bất kỳ chương trình Python nào) từ bất kỳ thư mục làm việc hiện tại nào.Add Python to PATH option, you can run the Python interpreter (and any Python program) from any current working directory.

Để kiểm tra điều này, hãy đưa ra lệnh C:\Users\IEUser>5:

Phiên bản Python sẽ được in (ví dụ: C:\Users\IEUser>6) và bạn sẽ quay lại dấu nhắc Windows. Bạn vừa chạy Python ở chế độ không tương tác, có nghĩa là bạn đã cung cấp một lệnh chính xác ("Python, in số phiên bản bạn là"), trình thông dịch Python đã thực hiện những gì bạn đã yêu cầu, và sau đó nó đã trả lại điều khiển cho dấu nhắc lệnh của Windows .non-interactive mode, meaning that you provided a precise command ("Python, print the version number you are"), the Python interpreter performed what you asked for, and then it returned control to the Command Prompt of Windows.

Chế độ không tương tác là cách hầu hết các chương trình Python hoạt động.non-interactive mode is how most Python programs work.

Nếu bạn quên thêm tham số C:\Users\IEUser>7 sau lệnh C:\Users\IEUser>8, bạn sẽ nhập Shell Python tương tác thay thế: thay vào đó:interactive Python shell instead:

Lưu ý cách lời nhắc thay đổi thành C:\Users\IEUser>9.

Để thoát khỏi vỏ Python và quay lại dấu nhắc lệnh, chỉ cần nhập C:\Users\IEUser0 và nhấn phím Enter/Return:

Thảo luận về vỏ tương tác nằm ngoài phạm vi của hướng dẫn này, vì hầu hết các chương trình bạn quan tâm là không tương tác.most programs you are interested in are non-interactive.

Chạy chương trình Python

Tuyệt vời, bây giờ bạn có tất cả các công cụ cần thiết để chạy chương trình Python trên dòng lệnh.

Như một minh họa, tôi sẽ sử dụng tập lệnh Python đơn giản của mình C:\Users\IEUser1, đọc các chú thích và điểm nổi bật từ tệp cơ sở dữ liệu của thiết bị Ereader Kobo (C:\Users\IEUser2) và in chúng trên dấu nhắc hoặc xuất chúng sang tệp đầu ra.

Bước 1: Tải xuống mã nguồn

Đầu tiên, tải xuống mã nguồn của chương trình Python bạn muốn chạy.

Điều này thường ngụ ý tải xuống một tệp mã nguồn Python duy nhất (với tiện ích mở rộng .py) hoặc tệp zip chứa một số tệp mã nguồn Python và các tệp tài nguyên khác mà bạn cần giải nén ở đâu đó trên đĩa của mình.downloading either a single Python source code file (with extension .py), or a ZIP file containing several Python source code files and other resource files that you need to uncompress somewhere on your disk.

Các chi tiết chính xác phụ thuộc vào chương trình Python của bạn, do đó chắc chắn sẽ đọc kỹ tài liệu cài đặt của nó. Bạn có thể tải xuống các tệp theo quy định với trình duyệt của mình và sau đó sao chép/giải nén chúng bằng Trình quản lý tệp đồ họa Windows.carefully read its install documentation. You can download the prescribed files with your browser, and then copy/uncompress them using the Windows graphical file manager.

Trong ví dụ của chúng tôi, chúng tôi tải xuống tệp RAW C:\Users\IEUser4 từ kho lưu trữ GitHub.

Hãy nhớ quy tắc an toàn 3 ("Sao chép các tệp python của bạn vào một thư mục riêng")?Safety Rule 3 ("copy your Python files into a separate folder")?

Chúng tôi đặt tệp C:\Users\IEUser4 đã tải xuống vào một thư mục mới C:\Users\IEUser6:

Lưu ý rằng chúng tôi cũng đã sao chép tệp C:\Users\IEUser2 (đầu vào của chương trình Python của chúng tôi) từ trình ereader KOBO của chúng tôi sang cùng một thư mục.

Bước 2: Mở dấu nhắc lệnh và C:\Users\IEUser> python my_awesome_program.py 6 ở đó

Sau đó, mở một dấu nhắc lệnh như được giải thích ở trên và thay đổi thư mục làm việc hiện tại thành thư mục nơi bạn đặt các tệp nguồn chương trình Python của mình.

Trong ví dụ của chúng tôi, C:\Users\IEUser9:

Một giải pháp thay thế đơn giản hơn để sử dụng lệnh

C:\Users\IEUser> python my_awesome_program.py

và chọn menu >1:

Bạn sẽ nhận được một cửa sổ nhắc lệnh mới, đã được đặt tại thư mục chính xác:

Bước 3: Chạy chương trình Python

Tại thời điểm này, chúng tôi đã sẵn sàng để chạy chương trình của chúng tôi.

Loại >2 và nhấn Enter/Return:

Trình thông dịch Python sẽ tải chương trình C:\Users\IEUser4 của chúng tôi và chạy nó với các đối số C:\Users\IEUser2 và >5.

Rõ ràng, ngữ nghĩa của các đối số khác nhau tùy theo chương trình, tùy thuộc vào những gì mỗi chương trình được cho là phải làm.the semantics of the arguments vary from program to program, depending on what each program is supposed to do.

Trong trường hợp của chúng tôi, C:\Users\IEUser4 sẽ đọc tệp có tên được truyền dưới dạng tham số đầu tiên (C:\Users\IEUser2) và nó sẽ liệt kê (tùy chọn >5) các tiêu đề của tất cả các ebook có chú thích hoặc điểm nổi bật trong cơ sở dữ liệu.

Nếu chúng tôi chỉ định các đối số lệnh khác nhau, ví dụ >9, chúng tôi sẽ nhận được một hành vi khác:

Cụ thể, lệnh thứ hai này đã xuất tất cả thông tin có trong tệp C:\Users\IEUser2 vào tệp mới được tạo có tên C:\Users\IEUser1 ở định dạng CSV:

Bạn phải kiểm tra tài liệu của chương trình Python của bạn để biết ngữ nghĩa của các đối số của nó.check the documentation of your Python program to know the semantics of its arguments.

Thông thường, nếu bạn chạy một chương trình Python mà không có đối số, bạn sẽ nhận được bản tóm tắt các đối số được chấp nhận:

Nếu đối số C:\Users\IEUser2 hoặc C:\Users\IEUser3 được đưa ra, thì một thông báo trợ giúp dài dòng sẽ được in:

Xin chúc mừng, bây giờ bạn sẽ có thể tự mình tải xuống và chạy một chương trình Python!

Sự nhìn nhận

• Louise Schofield nee Stokes khi đề xuất sử dụng menu File Explorer để mở dấu nhắc lệnh tại một thư mục nhất định for suggesting using the file explorer menu to open the command prompt at a given directory