Guida alla Risoluzione dei Problemi

Questa guida fornisce soluzioni ai problemi comuni che potresti incontrare mentre lavori con il curriculum "Data Science for Beginners".

Indice

Problemi con Python e Jupyter

Python Non Trovato o Versione Errata

Problema: python: command not found o versione errata di Python

Soluzione:

# 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

Soluzione per Windows:

Reinstalla Python da python.org
Durante l'installazione, seleziona "Add Python to PATH"
Riavvia il terminale/prompt dei comandi

Problemi di Attivazione dell'Ambiente Virtuale

Problema: L'ambiente virtuale non si attiva

Soluzione:

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

Verifica dell'attivazione:

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

Problemi con il Kernel di Jupyter

Problema: "Kernel non trovato" o "Kernel continua a morire"

Soluzione:

# 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

Problema: Versione errata di Python in Jupyter

Soluzione:

# 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)

Problemi con Pacchetti e Dipendenze

Errori di Importazione

Problema: ModuleNotFoundError: No module named 'pandas' (o altri pacchetti)

Soluzione:

# 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__)"

Fallimenti nell'Installazione con Pip

Problema: pip install fallisce con errori di permessi

Soluzione:

# 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

Problema: pip install fallisce con errori di certificato SSL

Soluzione:

# 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

Conflitti di Versione dei Pacchetti

Problema: Versioni incompatibili dei pacchetti

Soluzione:

# 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

Problemi con Jupyter Notebook

Jupyter Non Si Avvia

Problema: Comando jupyter notebook non trovato

Soluzione:

# 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 Non Si Carica o Non Si Salva

Problema: "Notebook non caricato" o errori di salvataggio

Soluzione:

Controlla i permessi dei file

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

Controlla la corruzione dei file

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

Cancella la cache di Jupyter

jupyter notebook --clear-cache

Celle Non Eseguono

Problema: La cella rimane bloccata su "In [*]" o impiega troppo tempo

Soluzione:

Interrompi il kernel: Clicca sul pulsante "Interrupt" o premi I, I
Riavvia il kernel: Menu Kernel → Restart
Controlla cicli infiniti nel tuo codice
Cancella output: Cell → All Output → Clear

Grafici Non Visualizzati

Problema: I grafici di matplotlib non vengono mostrati nel notebook

Soluzione:

# 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()

Alternativa per grafici interattivi:

%matplotlib notebook
# Or
%matplotlib widget

Problemi con l'Applicazione Quiz

npm install Fallisce

Problema: Errori durante npm install

Soluzione:

# 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

L'Applicazione Quiz Non Si Avvia

Problema: npm run serve fallisce

Soluzione:

# 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

Porta Già in Uso

Problema: "Porta 8080 già in uso"

Soluzione:

# 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 Non Carica o Pagina Bianca

Problema: L'app quiz si carica ma mostra una pagina bianca

Soluzione:

Controlla gli errori nella console del browser (F12)
Cancella cache e cookie del browser
Prova un browser diverso
Assicurati che JavaScript sia abilitato
Controlla se i blocchi pubblicitari interferiscono

# Rebuild the app
npm run build
npm run serve

Problemi con Git e GitHub

Git Non Riconosciuto

Problema: git: command not found

Soluzione:

Windows:

Installa Git da git-scm.com
Riavvia il terminale dopo l'installazione

macOS:

Nota: Se non hai Homebrew installato, segui le istruzioni su https://brew.sh/ per installarlo prima.

# 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 Fallisce

Problema: git clone fallisce con errori di autenticazione

Soluzione:

# 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

Permesso Negato (publickey)

Problema: Autenticazione con chiave SSH fallisce

Soluzione:

# 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

Problemi con la Documentazione Docsify

Comando Docsify Non Trovato

Problema: docsify: command not found

Soluzione:

# 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"

Documentazione Non Carica

Problema: Docsify si avvia ma il contenuto non si carica

Soluzione:

# 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)

Immagini Non Visualizzate

Problema: Le immagini mostrano l'icona di link rotto

Soluzione:

Controlla che i percorsi delle immagini siano relativi
Assicurati che i file immagine esistano nel repository
Cancella la cache del browser
Verifica che le estensioni dei file corrispondano (case-sensitive su alcuni sistemi)

Problemi con Dati e File

Errori di File Non Trovato

Problema: FileNotFoundError durante il caricamento dei dati

Soluzione:

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'))

Errori di Lettura CSV

Problema: Errori durante la lettura di file CSV

Soluzione:

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=';')

Errori di Memoria con Dataset Grandi

Problema: MemoryError durante il caricamento di file grandi

Soluzione:

# 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'})

Problemi di Prestazioni

Prestazioni Lente del Notebook

Problema: I notebook funzionano molto lentamente

Soluzione:

Riavvia il kernel e cancella l'output
- Kernel → Restart & Clear Output
Chiudi i notebook non utilizzati
Ottimizza il codice:

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

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

Campiona dataset grandi:

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

Crash del Browser

Problema: Il browser si blocca o diventa non responsivo

Soluzione:

Chiudi le schede non utilizzate
Cancella la cache del browser
Aumenta la memoria del browser (Chrome: chrome://settings/system)
Usa JupyterLab invece:

pip install jupyterlab
jupyter lab

Ottenere Ulteriore Aiuto

Prima di Chiedere Aiuto

Controlla questa guida alla risoluzione dei problemi
Cerca su GitHub Issues
Consulta INSTALLATION.md e USAGE.md
Prova a cercare il messaggio di errore online

Come Chiedere Aiuto

Quando crei un problema o chiedi aiuto, includi:

Sistema Operativo: Windows, macOS o Linux (quale distribuzione)
Versione di Python: Esegui python --version
Messaggio di Errore: Copia il messaggio di errore completo
Passaggi per Riprodurre: Cosa hai fatto prima che si verificasse l'errore
Cosa Hai Provato: Soluzioni che hai già tentato

Esempio:

**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

Risorse della Comunità

GitHub Issues: Crea un problema
Discord: Unisciti alla nostra comunità
Discussioni: Discussioni su GitHub
Microsoft Learn: Forum di Q&A

Documentazione Correlata

INSTALLATION.md - Istruzioni per l'installazione
USAGE.md - Come utilizzare il curriculum
CONTRIBUTING.md - Come contribuire
README.md - Panoramica del progetto

Disclaimer:
Questo documento è stato tradotto utilizzando il servizio di traduzione automatica Co-op Translator. Sebbene ci impegniamo per garantire l'accuratezza, si prega di notare che le traduzioni automatiche possono contenere errori o imprecisioni. Il documento originale nella sua lingua nativa dovrebbe essere considerato la fonte autorevole. Per informazioni critiche, si raccomanda una traduzione professionale effettuata da un traduttore umano. Non siamo responsabili per eventuali incomprensioni o interpretazioni errate derivanti dall'uso di questa traduzione.

Uh oh!

FilesExpand file tree

TROUBLESHOOTING.md

Latest commit

History

TROUBLESHOOTING.md

File metadata and controls

Guida alla Risoluzione dei Problemi

Indice

Problemi con Python e Jupyter

Python Non Trovato o Versione Errata

Problemi di Attivazione dell'Ambiente Virtuale

Problemi con il Kernel di Jupyter

Problemi con Pacchetti e Dipendenze

Errori di Importazione

Fallimenti nell'Installazione con Pip

Conflitti di Versione dei Pacchetti

Problemi con Jupyter Notebook

Jupyter Non Si Avvia

Notebook Non Si Carica o Non Si Salva

Celle Non Eseguono

Grafici Non Visualizzati

Problemi con l'Applicazione Quiz

npm install Fallisce

L'Applicazione Quiz Non Si Avvia

Porta Già in Uso

Quiz Non Carica o Pagina Bianca

Problemi con Git e GitHub

Git Non Riconosciuto

Clone Fallisce

Permesso Negato (publickey)

Problemi con la Documentazione Docsify

Comando Docsify Non Trovato

Documentazione Non Carica

Immagini Non Visualizzate

Problemi con Dati e File

Errori di File Non Trovato

Errori di Lettura CSV

Errori di Memoria con Dataset Grandi

Problemi di Prestazioni

Prestazioni Lente del Notebook

Crash del Browser

Ottenere Ulteriore Aiuto

Prima di Chiedere Aiuto

Come Chiedere Aiuto

Risorse della Comunità

Documentazione Correlata