Przewodnik rozwiązywania problemów

Ten przewodnik zawiera rozwiązania typowych problemów, które możesz napotkać podczas pracy z programem nauczania "Data Science for Beginners".

Spis treści

Problemy z Pythonem i Jupyter

Python nie znaleziony lub niewłaściwa wersja

Problem: python: command not found lub niewłaściwa wersja Pythona

Rozwiązanie:

# Check Python version
python --version
python3 --version

# If Python 3 is installed as 'python3', create an alias
# On macOS/Linux, add to ~/.bashrc or ~/.zshrc:
alias python=python3
alias pip=pip3

# Or use python3 explicitly
python3 -m pip install jupyter

Rozwiązanie dla Windows:

Zainstaluj ponownie Pythona z python.org
Podczas instalacji zaznacz opcję "Add Python to PATH"
Uruchom ponownie terminal/wiersz poleceń

Problemy z aktywacją wirtualnego środowiska

Problem: Wirtualne środowisko nie chce się aktywować

Rozwiązanie:

Windows:

# If you get execution policy error
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# Then activate
venv\Scripts\activate

macOS/Linux:

# Ensure the activate script is executable
chmod +x venv/bin/activate

# Then activate
source venv/bin/activate

Sprawdź aktywację:

# Your prompt should show (venv)
# Check Python location
which python  # Should point to venv

Problemy z Jupyter Kernel

Problem: "Kernel not found" lub "Kernel keeps dying"

Rozwiązanie:

# Reinstall kernel
python -m ipykernel install --user --name=datascience --display-name="Python (Data Science)"

# Or use the default kernel
python -m ipykernel install --user

# Restart Jupyter
jupyter notebook

Problem: Niewłaściwa wersja Pythona w Jupyter

Rozwiązanie:

# Install Jupyter in your virtual environment
source venv/bin/activate  # Activate first
pip install jupyter ipykernel

# Register the kernel
python -m ipykernel install --user --name=venv --display-name="Python (venv)"

# In Jupyter, select Kernel -> Change kernel -> Python (venv)

Problemy z pakietami i zależnościami

Błędy importu

Problem: ModuleNotFoundError: No module named 'pandas' (lub inne pakiety)

Rozwiązanie:

# Ensure virtual environment is activated
source venv/bin/activate  # macOS/Linux
venv\Scripts\activate     # Windows

# Install missing package
pip install pandas

# Install all common packages
pip install jupyter pandas numpy matplotlib seaborn scikit-learn

# Verify installation
python -c "import pandas; print(pandas.__version__)"

Problemy z instalacją pip

Problem: pip install kończy się błędami uprawnień

Rozwiązanie:

# Use --user flag
pip install --user package-name

# Or use virtual environment (recommended)
python -m venv venv
source venv/bin/activate
pip install package-name

Problem: pip install kończy się błędami certyfikatu SSL

Rozwiązanie:

# Update pip first
python -m pip install --upgrade pip

# Try installing with trusted host (temporary workaround)
pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org package-name

Konflikty wersji pakietów

Problem: Niekompatybilne wersje pakietów

Rozwiązanie:

# Create fresh virtual environment
python -m venv venv-new
source venv-new/bin/activate  # or venv-new\Scripts\activate on Windows

# Install packages with specific versions if needed
pip install pandas==1.3.0
pip install numpy==1.21.0

# Or let pip resolve dependencies
pip install jupyter pandas numpy matplotlib seaborn scikit-learn

Problemy z Jupyter Notebook

Jupyter nie chce się uruchomić

Problem: Komenda jupyter notebook nie została znaleziona

Rozwiązanie:

# Install Jupyter
pip install jupyter

# Or use python -m
python -m jupyter notebook

# Add to PATH if needed (macOS/Linux)
export PATH="$HOME/.local/bin:$PATH"

Notebook nie chce się załadować lub zapisać

Problem: "Notebook failed to load" lub błędy zapisu

Rozwiązanie:

Sprawdź uprawnienia do plików

# Make sure you have write permissions
ls -l notebook.ipynb
chmod 644 notebook.ipynb  # If needed

Sprawdź, czy plik nie jest uszkodzony

# Try opening in text editor to check JSON structure
# Copy content to new notebook if corrupted

Wyczyść pamięć podręczną Jupyter

jupyter notebook --clear-cache

Komórka nie chce się wykonać

Problem: Komórka utknęła na "In [*]" lub wykonuje się bardzo długo

Rozwiązanie:

Przerwij kernel: Kliknij przycisk "Interrupt" lub naciśnij I, I
Zrestartuj kernel: Menu Kernel → Restart
Sprawdź, czy w kodzie nie ma pętli nieskończonych
Wyczyść wyniki: Cell → All Output → Clear

Wykresy nie wyświetlają się

Problem: Wykresy matplotlib nie pojawiają się w notebooku

Rozwiązanie:

# Add magic command at the top of notebook
%matplotlib inline

import matplotlib.pyplot as plt

# Create plot
plt.plot([1, 2, 3, 4])
plt.show()  # Make sure to call show()

Alternatywa dla interaktywnych wykresów:

%matplotlib notebook
# Or
%matplotlib widget

Problemy z aplikacją quizową

npm install kończy się błędami

Problem: Błędy podczas npm install

Rozwiązanie:

# Clear npm cache
npm cache clean --force

# Remove node_modules and package-lock.json
rm -rf node_modules package-lock.json

# Reinstall
npm install

# If still failing, try with legacy peer deps
npm install --legacy-peer-deps

Aplikacja quizowa nie chce się uruchomić

Problem: npm run serve kończy się błędami

Rozwiązanie:

# Check Node.js version
node --version  # Should be 12.x or higher

# Reinstall dependencies
cd quiz-app
rm -rf node_modules package-lock.json
npm install

# Try different port
npm run serve -- --port 8081

Port już zajęty

Problem: "Port 8080 is already in use"

Rozwiązanie:

# Find and kill process on port 8080
# macOS/Linux:
lsof -ti:8080 | xargs kill -9

# Windows:
netstat -ano | findstr :8080
taskkill /PID <PID> /F

# Or use a different port
npm run serve -- --port 8081

Quiz nie ładuje się lub pokazuje pustą stronę

Problem: Aplikacja quizowa ładuje się, ale pokazuje pustą stronę

Rozwiązanie:

Sprawdź błędy w konsoli przeglądarki (F12)
Wyczyść pamięć podręczną i ciasteczka przeglądarki
Spróbuj użyć innej przeglądarki
Upewnij się, że JavaScript jest włączony
Sprawdź, czy blokery reklam nie przeszkadzają

# Rebuild the app
npm run build
npm run serve

Problemy z Git i GitHub

Git nie rozpoznany

Problem: git: command not found

Rozwiązanie:

Windows:

Zainstaluj Git z git-scm.com
Uruchom ponownie terminal po instalacji

macOS:

Uwaga: Jeśli nie masz zainstalowanego Homebrew, postępuj zgodnie z instrukcjami na https://brew.sh/, aby go zainstalować.

# Install via Homebrew
brew install git

# Or install Xcode Command Line Tools
xcode-select --install

Linux:

sudo apt-get install git  # Debian/Ubuntu
sudo dnf install git      # Fedora

Clone kończy się błędami

Problem: git clone kończy się błędami uwierzytelnienia

Rozwiązanie:

# Use HTTPS URL
git clone https://github.com/microsoft/Data-Science-For-Beginners.git

# If you have 2FA enabled on GitHub, use Personal Access Token
# Create token at: https://github.com/settings/tokens
# Use token as password when prompted

Permission Denied (publickey)

Problem: Błąd uwierzytelnienia klucza SSH

Rozwiązanie:

# Generate SSH key
ssh-keygen -t ed25519 -C "your_email@example.com"

# Add key to ssh-agent
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

# Add public key to GitHub
# Copy key: cat ~/.ssh/id_ed25519.pub
# Add at: https://github.com/settings/keys

Problemy z dokumentacją Docsify

Komenda Docsify nie została znaleziona

Problem: docsify: command not found

Rozwiązanie:

# Install globally
npm install -g docsify-cli

# If permission error on macOS/Linux
sudo npm install -g docsify-cli

# Verify installation
docsify --version

# If still not found, add npm global path
# Find npm global path
npm config get prefix

# Add to PATH (add to ~/.bashrc or ~/.zshrc)
export PATH="$PATH:/usr/local/bin"

Dokumentacja nie ładuje się

Problem: Docsify działa, ale treść się nie ładuje

Rozwiązanie:

# Ensure you're in the repository root
cd Data-Science-For-Beginners

# Check for index.html
ls index.html

# Serve with specific port
docsify serve --port 3000

# Check browser console for errors (F12)

Obrazy nie wyświetlają się

Problem: Obrazy pokazują ikonę uszkodzonego linku

Rozwiązanie:

Sprawdź, czy ścieżki do obrazów są względne
Upewnij się, że pliki obrazów istnieją w repozytorium
Wyczyść pamięć podręczną przeglądarki
Sprawdź, czy rozszerzenia plików są zgodne (wrażliwe na wielkość liter w niektórych systemach)

Problemy z danymi i plikami

Błędy "File Not Found"

Problem: FileNotFoundError podczas ładowania danych

Rozwiązanie:

import os

# Check current working directory
print(os.getcwd())

# Use absolute path
data_path = os.path.join(os.getcwd(), 'data', 'filename.csv')
df = pd.read_csv(data_path)

# Or use relative path from notebook location
df = pd.read_csv('../data/filename.csv')

# Verify file exists
print(os.path.exists('data/filename.csv'))

Błędy podczas odczytu CSV

Problem: Błędy podczas odczytu plików CSV

Rozwiązanie:

import pandas as pd

# Try different encodings
df = pd.read_csv('file.csv', encoding='utf-8')
# or
df = pd.read_csv('file.csv', encoding='latin-1')
# or
df = pd.read_csv('file.csv', encoding='ISO-8859-1')

# Handle missing values
df = pd.read_csv('file.csv', na_values=['NA', 'N/A', ''])

# Specify delimiter if not comma
df = pd.read_csv('file.csv', delimiter=';')

Błędy pamięci przy dużych zbiorach danych

Problem: MemoryError podczas ładowania dużych plików

Rozwiązanie:

# Read in chunks
chunk_size = 10000
chunks = []
for chunk in pd.read_csv('large_file.csv', chunksize=chunk_size):
    # Process chunk
    chunks.append(chunk)
df = pd.concat(chunks)

# Or read specific columns only
df = pd.read_csv('file.csv', usecols=['col1', 'col2'])

# Use more efficient data types
df = pd.read_csv('file.csv', dtype={'column_name': 'int32'})

Problemy z wydajnością

Wolne działanie notebooków

Problem: Notebooki działają bardzo wolno

Rozwiązanie:

Zrestartuj kernel i wyczyść wyniki
- Kernel → Restart & Clear Output
Zamknij nieużywane notebooki
Optymalizuj kod:

# Use vectorized operations instead of loops
# Bad:
result = []
for x in data:
    result.append(x * 2)

# Good:
result = data * 2  # NumPy/Pandas vectorization

Próbkuj duże zbiory danych:

# Work with sample during development
df_sample = df.sample(n=1000)  # or df.head(1000)

Zawieszanie się przeglądarki

Problem: Przeglądarka zawiesza się lub staje się nieodpowiedzialna

Rozwiązanie:

Zamknij nieużywane karty
Wyczyść pamięć podręczną przeglądarki
Zwiększ pamięć przeglądarki (Chrome: chrome://settings/system)
Użyj JupyterLab zamiast:

pip install jupyterlab
jupyter lab

Uzyskiwanie dodatkowej pomocy

Zanim poprosisz o pomoc

Sprawdź ten przewodnik rozwiązywania problemów
Przeszukaj GitHub Issues
Przejrzyj INSTALLATION.md i USAGE.md
Spróbuj wyszukać komunikat błędu w internecie

Jak poprosić o pomoc

Tworząc zgłoszenie lub prosząc o pomoc, podaj:

System operacyjny: Windows, macOS lub Linux (jaka dystrybucja)
Wersja Pythona: Uruchom python --version
Komunikat błędu: Skopiuj pełny komunikat błędu
Kroki do odtworzenia: Co zrobiłeś przed wystąpieniem błędu
Co już próbowałeś: Rozwiązania, które już wypróbowałeś

Przykład:

**Operating System:** macOS 12.0
**Python Version:** 3.9.7
**Error Message:** ModuleNotFoundError: No module named 'pandas'
**Steps to Reproduce:**
1. Activated virtual environment
2. Started Jupyter notebook
3. Tried to import pandas

**What I've Tried:**
- Ran pip install pandas
- Restarted Jupyter

Zasoby społecznościowe

GitHub Issues: Utwórz zgłoszenie
Discord: Dołącz do naszej społeczności
Dyskusje: GitHub Discussions
Microsoft Learn: Fora Q&A

Powiązana dokumentacja

INSTALLATION.md - Instrukcje instalacji
USAGE.md - Jak korzystać z programu nauczania
CONTRIBUTING.md - Jak wnosić wkład
README.md - Przegląd projektu

Zastrzeżenie:
Ten dokument został przetłumaczony za pomocą usługi tłumaczenia AI Co-op Translator. Chociaż staramy się zapewnić dokładność, prosimy pamiętać, że automatyczne tłumaczenia mogą zawierać błędy lub nieścisłości. Oryginalny dokument w jego języku źródłowym powinien być uznawany za autorytatywne źródło. W przypadku informacji krytycznych zaleca się skorzystanie z profesjonalnego tłumaczenia przez człowieka. Nie ponosimy odpowiedzialności za jakiekolwiek nieporozumienia lub błędne interpretacje wynikające z użycia tego tłumaczenia.

FilesExpand file tree

TROUBLESHOOTING.md

Latest commit

History

TROUBLESHOOTING.md

File metadata and controls

Przewodnik rozwiązywania problemów

Spis treści

Problemy z Pythonem i Jupyter

Python nie znaleziony lub niewłaściwa wersja

Problemy z aktywacją wirtualnego środowiska

Problemy z Jupyter Kernel

Problemy z pakietami i zależnościami

Błędy importu

Problemy z instalacją pip

Konflikty wersji pakietów

Problemy z Jupyter Notebook

Jupyter nie chce się uruchomić

Notebook nie chce się załadować lub zapisać

Komórka nie chce się wykonać

Wykresy nie wyświetlają się

Problemy z aplikacją quizową

npm install kończy się błędami

Aplikacja quizowa nie chce się uruchomić

Port już zajęty

Quiz nie ładuje się lub pokazuje pustą stronę

Problemy z Git i GitHub

Git nie rozpoznany

Clone kończy się błędami

Permission Denied (publickey)

Problemy z dokumentacją Docsify

Komenda Docsify nie została znaleziona

Dokumentacja nie ładuje się

Obrazy nie wyświetlają się

Problemy z danymi i plikami

Błędy "File Not Found"

Błędy podczas odczytu CSV

Błędy pamięci przy dużych zbiorach danych

Problemy z wydajnością

Wolne działanie notebooków

Zawieszanie się przeglądarki

Uzyskiwanie dodatkowej pomocy

Zanim poprosisz o pomoc

Jak poprosić o pomoc

Zasoby społecznościowe

Powiązana dokumentacja