18 KiB
Οδηγός Αντιμετώπισης Προβλημάτων
Αυτός ο οδηγός παρέχει λύσεις σε κοινά προβλήματα που μπορεί να αντιμετωπίσετε κατά την εργασία σας με το πρόγραμμα σπουδών "Data Science for Beginners".
Πίνακας Περιεχομένων
- Προβλήματα με Python και Jupyter
- Προβλήματα με Πακέτα και Εξαρτήσεις
- Προβλήματα με Jupyter Notebook
- Προβλήματα με την Εφαρμογή Quiz
- Προβλήματα με Git και GitHub
- Προβλήματα με την Τεκμηρίωση Docsify
- Προβλήματα με Δεδομένα και Αρχεία
- Προβλήματα Απόδοσης
- Πώς να Ζητήσετε Επιπλέον Βοήθεια
Προβλήματα με Python και Jupyter
Python Δεν Βρέθηκε ή Λάθος Έκδοση
Πρόβλημα: python: command not found ή λάθος έκδοση Python
Λύση:
# 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
Λύση για Windows:
- Εγκαταστήστε ξανά την Python από python.org
- Κατά την εγκατάσταση, επιλέξτε "Add Python to PATH"
- Επανεκκινήστε το τερματικό/προτροπή εντολών
Προβλήματα Ενεργοποίησης Εικονικού Περιβάλλοντος
Πρόβλημα: Το εικονικό περιβάλλον δεν ενεργοποιείται
Λύση:
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
Επαλήθευση ενεργοποίησης:
# Your prompt should show (venv)
# Check Python location
which python # Should point to venv
Προβλήματα Kernel στο Jupyter
Πρόβλημα: "Kernel not found" ή "Kernel keeps dying"
Λύση:
# 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
Πρόβλημα: Λάθος έκδοση Python στο Jupyter
Λύση:
# 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)
Προβλήματα με Πακέτα και Εξαρτήσεις
Σφάλματα Εισαγωγής
Πρόβλημα: ModuleNotFoundError: No module named 'pandas' (ή άλλα πακέτα)
Λύση:
# 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__)"
Αποτυχίες Εγκατάστασης με Pip
Πρόβλημα: pip install αποτυγχάνει με σφάλματα δικαιωμάτων
Λύση:
# 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
Πρόβλημα: pip install αποτυγχάνει με σφάλματα πιστοποιητικών SSL
Λύση:
# 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
Συγκρούσεις Εκδόσεων Πακέτων
Πρόβλημα: Μη συμβατές εκδόσεις πακέτων
Λύση:
# 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
Προβλήματα με Jupyter Notebook
Το Jupyter Δεν Ξεκινά
Πρόβλημα: Η εντολή jupyter notebook δεν βρέθηκε
Λύση:
# 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 Δεν Φορτώνει ή Δεν Αποθηκεύεται
Πρόβλημα: "Notebook failed to load" ή σφάλματα αποθήκευσης
Λύση:
- Ελέγξτε τα δικαιώματα αρχείων
# Make sure you have write permissions
ls -l notebook.ipynb
chmod 644 notebook.ipynb # If needed
- Ελέγξτε για καταστροφή αρχείων
# Try opening in text editor to check JSON structure
# Copy content to new notebook if corrupted
- Καθαρίστε την προσωρινή μνήμη του Jupyter
jupyter notebook --clear-cache
Το Κελί Δεν Εκτελείται
Πρόβλημα: Το κελί μένει κολλημένο στο "In [*]" ή παίρνει πολύ χρόνο
Λύση:
- Διακόψτε τον kernel: Πατήστε το κουμπί "Interrupt" ή πατήστε
I, I - Επανεκκινήστε τον kernel: Μενού Kernel → Restart
- Ελέγξτε για άπειρους βρόχους στον κώδικά σας
- Καθαρίστε την έξοδο: Cell → All Output → Clear
Τα Γραφήματα Δεν Εμφανίζονται
Πρόβλημα: Τα γραφήματα matplotlib δεν εμφανίζονται στο notebook
Λύση:
# 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()
Εναλλακτική για διαδραστικά γραφήματα:
%matplotlib notebook
# Or
%matplotlib widget
Προβλήματα με την Εφαρμογή Quiz
Αποτυχία npm install
Πρόβλημα: Σφάλματα κατά την εκτέλεση του npm install
Λύση:
# 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
Η Εφαρμογή Quiz Δεν Ξεκινά
Πρόβλημα: Το npm run serve αποτυγχάνει
Λύση:
# 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 8080 is already in use"
Λύση:
# 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 Δεν Φορτώνει ή Εμφανίζεται Κενή Σελίδα
Πρόβλημα: Η εφαρμογή Quiz φορτώνει αλλά εμφανίζει κενή σελίδα
Λύση:
- Ελέγξτε την κονσόλα του προγράμματος περιήγησης για σφάλματα (F12)
- Καθαρίστε την προσωρινή μνήμη και τα cookies του προγράμματος περιήγησης
- Δοκιμάστε διαφορετικό πρόγραμμα περιήγησης
- Βεβαιωθείτε ότι η JavaScript είναι ενεργοποιημένη
- Ελέγξτε αν οι αποκλειστές διαφημίσεων προκαλούν παρεμβολές
# Rebuild the app
npm run build
npm run serve
Προβλήματα με Git και GitHub
Το Git Δεν Αναγνωρίζεται
Πρόβλημα: git: command not found
Λύση:
Windows:
- Εγκαταστήστε το Git από git-scm.com
- Επανεκκινήστε το τερματικό μετά την εγκατάσταση
macOS:
Σημείωση: Αν δεν έχετε εγκαταστήσει το Homebrew, ακολουθήστε τις οδηγίες στο https://brew.sh/ για να το εγκαταστήσετε πρώτα.
# 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
Αποτυχία Κλωνοποίησης
Πρόβλημα: Το git clone αποτυγχάνει με σφάλματα πιστοποίησης
Λύση:
# 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
Άρνηση Δικαιωμάτων (publickey)
Πρόβλημα: Η πιστοποίηση με SSH key αποτυγχάνει
Λύση:
# 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
Προβλήματα με την Τεκμηρίωση Docsify
Η Εντολή Docsify Δεν Βρέθηκε
Πρόβλημα: docsify: command not found
Λύση:
# 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"
Η Τεκμηρίωση Δεν Φορτώνει
Πρόβλημα: Το Docsify εξυπηρετεί αλλά το περιεχόμενο δεν φορτώνει
Λύση:
# 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)
Οι Εικόνες Δεν Εμφανίζονται
Πρόβλημα: Οι εικόνες εμφανίζουν εικονίδιο σπασμένου συνδέσμου
Λύση:
- Ελέγξτε αν οι διαδρομές εικόνων είναι σχετικές
- Βεβαιωθείτε ότι τα αρχεία εικόνων υπάρχουν στο αποθετήριο
- Καθαρίστε την προσωρινή μνήμη του προγράμματος περιήγησης
- Επαληθεύστε ότι οι επεκτάσεις αρχείων ταιριάζουν (ευαίσθητο σε πεζά/κεφαλαία σε ορισμένα συστήματα)
Προβλήματα με Δεδομένα και Αρχεία
Σφάλματα "File Not Found"
Πρόβλημα: FileNotFoundError κατά τη φόρτωση δεδομένων
Λύση:
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'))
Σφάλματα Ανάγνωσης CSV
Πρόβλημα: Σφάλματα κατά την ανάγνωση αρχείων CSV
Λύση:
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=';')
Σφάλματα Μνήμης με Μεγάλα Σύνολα Δεδομένων
Πρόβλημα: MemoryError κατά τη φόρτωση μεγάλων αρχείων
Λύση:
# 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'})
Προβλήματα Απόδοσης
Αργή Απόδοση Notebook
Πρόβλημα: Τα notebooks εκτελούνται πολύ αργά
Λύση:
-
Επανεκκινήστε τον kernel και καθαρίστε την έξοδο
- Kernel → Restart & Clear Output
-
Κλείστε αχρησιμοποίητα notebooks
-
Βελτιστοποιήστε τον κώδικα:
# Use vectorized operations instead of loops
# Bad:
result = []
for x in data:
result.append(x * 2)
# Good:
result = data * 2 # NumPy/Pandas vectorization
- Δειγματοληψία μεγάλων συνόλων δεδομένων:
# Work with sample during development
df_sample = df.sample(n=1000) # or df.head(1000)
Κατάρρευση Προγράμματος Περιήγησης
Πρόβλημα: Το πρόγραμμα περιήγησης καταρρέει ή γίνεται μη ανταποκρίσιμο
Λύση:
- Κλείστε αχρησιμοποίητες καρτέλες
- Καθαρίστε την προσωρινή μνήμη του προγράμματος περιήγησης
- Αυξήστε τη μνήμη του προγράμματος περιήγησης (Chrome:
chrome://settings/system) - Χρησιμοποιήστε το JupyterLab αντί:
pip install jupyterlab
jupyter lab
Πώς να Ζητήσετε Επιπλέον Βοήθεια
Πριν Ζητήσετε Βοήθεια
- Ελέγξτε αυτόν τον οδηγό αντιμετώπισης προβλημάτων
- Αναζητήστε στα GitHub Issues
- Εξετάστε τα INSTALLATION.md και USAGE.md
- Δοκιμάστε να αναζητήσετε το μήνυμα σφάλματος στο διαδίκτυο
Πώς να Ζητήσετε Βοήθεια
Όταν δημιουργείτε ένα ζήτημα ή ζητάτε βοήθεια, συμπεριλάβετε:
- Λειτουργικό Σύστημα: Windows, macOS ή Linux (ποια διανομή)
- Έκδοση Python: Εκτελέστε
python --version - Μήνυμα Σφάλματος: Αντιγράψτε το πλήρες μήνυμα σφάλματος
- Βήματα Αναπαραγωγής: Τι κάνατε πριν εμφανιστεί το σφάλμα
- Τι Έχετε Δοκιμάσει: Λύσεις που έχετε ήδη επιχειρήσει
Παράδειγμα:
**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
Πόροι Κοινότητας
- GitHub Issues: Δημιουργήστε ένα ζήτημα
- Discord: Εγγραφείτε στην κοινότητά μας
- Συζητήσεις: GitHub Discussions
- Microsoft Learn: Φόρουμ Ερωτήσεων & Απαντήσεων
Σχετική Τεκμηρίωση
- INSTALLATION.md - Οδηγίες εγκατάστασης
- USAGE.md - Πώς να χρησιμοποιήσετε το πρόγραμμα σπουδών
- CONTRIBUTING.md - Πώς να συνεισφέρετε
- README.md - Επισκόπηση του έργου
Αποποίηση ευθύνης:
Αυτό το έγγραφο έχει μεταφραστεί χρησιμοποιώντας την υπηρεσία αυτόματης μετάφρασης Co-op Translator. Παρόλο που καταβάλλουμε προσπάθειες για ακρίβεια, παρακαλούμε να γνωρίζετε ότι οι αυτόματες μεταφράσεις ενδέχεται να περιέχουν λάθη ή ανακρίβειες. Το πρωτότυπο έγγραφο στη μητρική του γλώσσα θα πρέπει να θεωρείται η αυθεντική πηγή. Για κρίσιμες πληροφορίες, συνιστάται επαγγελματική ανθρώπινη μετάφραση. Δεν φέρουμε ευθύνη για τυχόν παρεξηγήσεις ή εσφαλμένες ερμηνείες που προκύπτουν από τη χρήση αυτής της μετάφρασης.