13 KiB
Fejlfindingsguide
Denne guide giver løsninger på almindelige problemer, du kan støde på, mens du arbejder med Data Science for Beginners-kurset.
Indholdsfortegnelse
- Python og Jupyter-problemer
- Pakke- og afhængighedsproblemer
- Jupyter Notebook-problemer
- Quiz-applikationsproblemer
- Git og GitHub-problemer
- Docsify-dokumentationsproblemer
- Data- og filproblemer
- Ydelsesproblemer
- Få yderligere hjælp
Python og Jupyter-problemer
Python ikke fundet eller forkert version
Problem: python: command not found eller forkert Python-version
Løsning:
# 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
Løsning til Windows:
- Geninstaller Python fra python.org
- Under installationen, marker "Add Python to PATH"
- Genstart din terminal/kommandoprompt
Problemer med aktivering af virtuel miljø
Problem: Virtuelt miljø aktiveres ikke
Løsning:
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
Bekræft aktivering:
# Your prompt should show (venv)
# Check Python location
which python # Should point to venv
Jupyter Kernel-problemer
Problem: "Kernel not found" eller "Kernel keeps dying"
Løsning:
# 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: Forkert Python-version i Jupyter
Løsning:
# 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)
Pakke- og afhængighedsproblemer
Importfejl
Problem: ModuleNotFoundError: No module named 'pandas' (eller andre pakker)
Løsning:
# 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__)"
Fejl ved pip-installation
Problem: pip install fejler med tilladelsesfejl
Løsning:
# 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 fejler med SSL-certifikatfejl
Løsning:
# 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
Konflikter mellem pakkeversioner
Problem: Uforenelige pakkeversioner
Løsning:
# 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-problemer
Jupyter starter ikke
Problem: jupyter notebook kommando ikke fundet
Løsning:
# 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 kan ikke indlæses eller gemmes
Problem: "Notebook failed to load" eller gemmefejl
Løsning:
- Tjek filtilladelser
# Make sure you have write permissions
ls -l notebook.ipynb
chmod 644 notebook.ipynb # If needed
- Tjek for filkorruption
# Try opening in text editor to check JSON structure
# Copy content to new notebook if corrupted
- Ryd Jupyter-cache
jupyter notebook --clear-cache
Celle udføres ikke
Problem: Celle sidder fast på "In [*]" eller tager evigheder
Løsning:
- Afbryd kernen: Klik på "Interrupt"-knappen eller tryk
I, I - Genstart kernen: Kernel-menu → Restart
- Tjek for uendelige loops i din kode
- Ryd output: Cell → All Output → Clear
Diagrammer vises ikke
Problem: matplotlib diagrammer vises ikke i notebook
Løsning:
# 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()
Alternativ til interaktive diagrammer:
%matplotlib notebook
# Or
%matplotlib widget
Quiz-applikationsproblemer
npm install fejler
Problem: Fejl under npm install
Løsning:
# 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-app starter ikke
Problem: npm run serve fejler
Løsning:
# 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 allerede i brug
Problem: "Port 8080 is already in use"
Løsning:
# 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 indlæses ikke eller viser tom side
Problem: Quiz-app indlæses, men viser tom side
Løsning:
- Tjek browserkonsollen for fejl (F12)
- Ryd browserens cache og cookies
- Prøv en anden browser
- Sørg for, at JavaScript er aktiveret
- Tjek for adblockere, der kan forstyrre
# Rebuild the app
npm run build
npm run serve
Git og GitHub-problemer
Git ikke genkendt
Problem: git: command not found
Løsning:
Windows:
- Installer Git fra git-scm.com
- Genstart terminalen efter installation
macOS:
Bemærk: Hvis du ikke har Homebrew installeret, følg instruktionerne på https://brew.sh/ for at installere det først.
# 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 fejler
Problem: git clone fejler med autentificeringsfejl
Løsning:
# 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
Tilladelse nægtet (publickey)
Problem: SSH-nøgleautentificering fejler
Løsning:
# 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-dokumentationsproblemer
Docsify-kommando ikke fundet
Problem: docsify: command not found
Løsning:
# 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"
Dokumentation indlæses ikke
Problem: Docsify serverer, men indholdet indlæses ikke
Løsning:
# 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)
Billeder vises ikke
Problem: Billeder viser ikon for brudt link
Løsning:
- Tjek, at billedstier er relative
- Sørg for, at billedfiler findes i repository
- Ryd browserens cache
- Bekræft, at filendelser matcher (case-sensitive på nogle systemer)
Data- og filproblemer
Fil ikke fundet fejl
Problem: FileNotFoundError ved indlæsning af data
Løsning:
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'))
Fejl ved læsning af CSV
Problem: Fejl ved læsning af CSV-filer
Løsning:
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=';')
Hukommelsesfejl med store datasæt
Problem: MemoryError ved indlæsning af store filer
Løsning:
# 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'})
Ydelsesproblemer
Langsom notebook-ydelse
Problem: Notebooks kører meget langsomt
Løsning:
-
Genstart kernen og ryd output
- Kernel → Restart & Clear Output
-
Luk ubrugte notebooks
-
Optimer kode:
# Use vectorized operations instead of loops
# Bad:
result = []
for x in data:
result.append(x * 2)
# Good:
result = data * 2 # NumPy/Pandas vectorization
- Udtag store datasæt:
# Work with sample during development
df_sample = df.sample(n=1000) # or df.head(1000)
Browser går ned
Problem: Browser går ned eller bliver uresponsiv
Løsning:
- Luk ubrugte faner
- Ryd browserens cache
- Øg browserens hukommelse (Chrome:
chrome://settings/system) - Brug JupyterLab i stedet:
pip install jupyterlab
jupyter lab
Få yderligere hjælp
Før du beder om hjælp
- Tjek denne fejlfindingsguide
- Søg på GitHub Issues
- Gennemgå INSTALLATION.md og USAGE.md
- Prøv at søge fejlmeddelelsen online
Sådan beder du om hjælp
Når du opretter en issue eller beder om hjælp, inkluder:
- Operativsystem: Windows, macOS eller Linux (hvilken distribution)
- Python-version: Kør
python --version - Fejlmeddelelse: Kopiér den komplette fejlmeddelelse
- Trin til reproduktion: Hvad du gjorde, før fejlen opstod
- Hvad du har prøvet: Løsninger, du allerede har forsøgt
Eksempel:
**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
Fællesskabsressourcer
- GitHub Issues: Opret en issue
- Discord: Deltag i vores fællesskab
- Diskussioner: GitHub Discussions
- Microsoft Learn: Q&A-fora
Relateret dokumentation
- INSTALLATION.md - Installationsinstruktioner
- USAGE.md - Sådan bruges kurset
- CONTRIBUTING.md - Sådan bidrager du
- README.md - Projektoversigt
Ansvarsfraskrivelse:
Dette dokument er blevet oversat ved hjælp af AI-oversættelsestjenesten Co-op Translator. Selvom vi bestræber os på at sikre nøjagtighed, skal det bemærkes, at automatiserede oversættelser kan indeholde fejl eller unøjagtigheder. Det originale dokument på dets oprindelige sprog bør betragtes som den autoritative kilde. For kritisk information anbefales professionel menneskelig oversættelse. Vi påtager os ikke ansvar for misforståelser eller fejltolkninger, der måtte opstå som følge af brugen af denne oversættelse.