Python Academy · Lekcja

Uruchamianie poleceń za pomocą subprocess

Wykonuj zewnętrzne programy

Lekcja 1 z 413 kroki

Uruchamianie poleceń za pomocą subprocess to bezpłatna lekcja Python Academy na CoddyKit. To lekcja 1 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Python Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Python Academy zawiera 4 lekcji w sumie.

Czym jest subprocess?

Moduł subprocess pozwala programowi w Pythonie uruchamiać zewnętrzne polecenia i inne programy, tak jak po wpisaniu ich w terminalu.

import subprocess

result = subprocess.run(['echo', 'hello'])
print('return code:', result.returncode)

Podstawy subprocess.run

subprocess.run() jest zalecanym punktem wejścia. Polecenie należy przekazać jako listę argumentów: najpierw nazwę programu, a następnie każdy argument osobno.

import subprocess

result = subprocess.run(['echo', 'one', 'two'])
print('done with code', result.returncode)

Dlaczego lista, a nie ciąg znaków?

Przekazanie listy sprawia, że powłoka nie analizuje polecenia, co zapobiega błędom związanym z cudzysłowami i zagrożeniom związanym z wstrzyknięciem polecenia do powłoki. Każdy element jest jednym argumentem.

import subprocess

# Safe: each piece is its own argument
subprocess.run(['echo', 'a file with spaces.txt'])

Obiekt CompletedProcess

run() zwraca obiekt CompletedProcess zawierający wartości args, returncode oraz — jeśli przechwycono dane wyjściowe — również te dane. Kod 0 oznacza powodzenie.

import subprocess

cp = subprocess.run(['true'])
print('args:', cp.args)
print('returncode:', cp.returncode)

Sprawdzanie kodów powrotu

Niezerowy kod powrotu zwykle oznacza, że polecenie zakończyło się niepowodzeniem. Po wywołaniu można sprawdzić go ręcznie.

import subprocess

cp = subprocess.run(['ls', '/no/such/path'])
if cp.returncode != 0:
    print('command failed with', cp.returncode)

Zgłaszanie błędu za pomocą check=True

Przekazanie check=True sprawia, że run() automatycznie zgłasza wyjątek CalledProcessError, gdy polecenie zakończy się niezerowym kodem.

import subprocess

try:
    subprocess.run(['false'], check=True)
except subprocess.CalledProcessError as e:
    print('failed with code', e.returncode)

Przekazywanie argumentów

Dodatkowe argumenty polecenia to po prostu kolejne elementy listy. W tym przykładzie wyświetlamy zawartość katalogu w formacie szczegółowym.

import subprocess

subprocess.run(['echo', '-n', 'no newline'])
print()
print('above echo had -n flag')

Ustawianie limitu czasu

Użyj argumentu timeout, aby przerwać polecenie działające zbyt długo. Zostanie zgłoszony wyjątek TimeoutExpired.

import subprocess

try:
    subprocess.run(['sleep', '5'], timeout=0.1)
except subprocess.TimeoutExpired:
    print('command took too long, aborted')

Katalog roboczy

Argument cwd uruchamia polecenie w określonym katalogu bez zmieniania katalogu roboczego samego programu.

import subprocess

subprocess.run(['pwd'], cwd='/tmp')

Opcja shell=True

W przypadku shell=True przekazuje się pojedynczy ciąg polecenia, który interpretuje powłoka. Umożliwia to korzystanie z potoków i wzorców wieloznacznych, ale jest ryzykowne w przypadku niezaufanych danych wejściowych. Należy preferować formę z listą.

import subprocess

subprocess.run('echo hello && echo world', shell=True)

Unikanie os.system

Starsza funkcja os.system zwraca tylko kod wyjścia i nie oferuje bezpiecznego przekazywania argumentów ani przechwytywania danych wyjściowych. subprocess.run zastępuje ją we wszystkich nowych programach.

import subprocess

# Modern, safe approach
cp = subprocess.run(['echo', 'modern way'])
print('exit code:', cp.returncode)

Szybki test

Sprawdź, czy rozumie Pan / rozumie Pani zasady uruchamiania poleceń.

Odpowiedz w interaktywnej lekcji

Podsumowanie

Nauczył się Pan / Nauczyła się Pani uruchamiać polecenia za pomocą subprocess:

subprocess.run([...]) bezpiecznie uruchamia zewnętrzny program.
Zwraca obiekt CompletedProcess zawierający returncode.
check=True zgłasza wyjątek w razie niepowodzenia, a timeout przerywa zbyt wolne polecenia.
Należy preferować formę z listą zamiast shell=True.

Następnie: przechwytywanie danych wyjściowych polecenia.

Bezpłatny start

Ucz się Python dzięki korepetycjom AI — za darmo

Pisz i uruchamiaj kod w przeglądarce, otrzymuj natychmiastową pomoc od korepetytora AI dostępnego 24/7 i kontynuuj naukę w sieci lub w aplikacji.

Kursy: 76
Lekcje: 320

Zacznij naukę bezpłatnie Wyświetl pełny kurs

Często zadawane pytania

Czy lekcja „Uruchamianie poleceń za pomocą subprocess” jest bezpłatna?

Tak — pełny tekst „Uruchamianie poleceń za pomocą subprocess” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Python Academy, przejdź na CoddyKit PRO. Kurs Python Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Uruchamianie poleceń za pomocą subprocess”?

Wykonuj zewnętrzne programy Ćwiczysz Python Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Python Academy?

Nie wymagamy żadnego doświadczenia. Python Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 4.

Ile czasu zajmuje lekcja „Uruchamianie poleceń za pomocą subprocess”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Python Academy?

Tak. Każda lekcja Python Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

Uruchamianie poleceń za pomocą subprocess
Przechwytywanie danych wyjściowych
Środowisko i moduł os
shutil do operacji na plikach

← Powrót do Python Academy