17 KiB

Raw Blame History Unescape Escape

راهنمای رفع مشکلات

این راهنما به شما کمک می‌کند مشکلات رایج هنگام کار با دوره آموزشی یادگیری ماشین برای مبتدیان را حل کنید. اگر راه‌حلی در اینجا پیدا نکردید، لطفاً به بحث‌های دیسکورد مراجعه کنید یا یک مشکل جدید باز کنید.

فهرست مطالب

مشکلات نصب

نصب Python

مشکل: python: command not found

راه‌حل:

Python نسخه 3.8 یا بالاتر را از python.org نصب کنید.
نصب را تأیید کنید: python --version یا python3 --version
در macOS/Linux ممکن است نیاز باشد از python3 به جای python استفاده کنید.

مشکل: نسخه‌های متعدد Python باعث ایجاد تداخل می‌شوند.

راه‌حل:

# Use virtual environments to isolate projects
python -m venv ml-env

# Activate virtual environment
# On Windows:
ml-env\Scripts\activate
# On macOS/Linux:
source ml-env/bin/activate

نصب Jupyter

مشکل: jupyter: command not found

راه‌حل:

# Install Jupyter
pip install jupyter

# Or with pip3
pip3 install jupyter

# Verify installation
jupyter --version

مشکل: Jupyter در مرورگر باز نمی‌شود.

راه‌حل:

# Try specifying the browser
jupyter notebook --browser=chrome

# Or copy the URL with token from terminal and paste in browser manually
# Look for: http://localhost:8888/?token=...

نصب R

مشکل: بسته‌های R نصب نمی‌شوند.

راه‌حل:

# Ensure you have the latest R version
# Install packages with dependencies
install.packages(c("tidyverse", "tidymodels", "caret"), dependencies = TRUE)

# If compilation fails, try installing binary versions
install.packages("package-name", type = "binary")

مشکل: IRkernel در Jupyter موجود نیست.

راه‌حل:

# In R console
install.packages('IRkernel')
IRkernel::installspec(user = TRUE)

مشکلات Jupyter Notebook

مشکلات Kernel

مشکل: Kernel مدام از کار می‌افتد یا دوباره راه‌اندازی می‌شود.

راه‌حل:

Kernel را مجدداً راه‌اندازی کنید: Kernel → Restart
خروجی را پاک کرده و Kernel را مجدداً راه‌اندازی کنید: Kernel → Restart & Clear Output
مشکلات حافظه را بررسی کنید (به مشکلات عملکرد مراجعه کنید).
سلول‌ها را به صورت جداگانه اجرا کنید تا کد مشکل‌دار را شناسایی کنید.

مشکل: Kernel اشتباه انتخاب شده است.

راه‌حل:

Kernel فعلی را بررسی کنید: Kernel → Change Kernel
نسخه صحیح Python را انتخاب کنید.
اگر Kernel موجود نیست، آن را ایجاد کنید:

python -m ipykernel install --user --name=ml-env

مشکل: Kernel شروع نمی‌شود.

راه‌حل:

# Reinstall ipykernel
pip uninstall ipykernel
pip install ipykernel

# Register the kernel again
python -m ipykernel install --user

مشکلات سلول‌های Notebook

مشکل: سلول‌ها اجرا می‌شوند اما خروجی نشان داده نمی‌شود.

راه‌حل:

بررسی کنید آیا سلول هنوز در حال اجرا است (به دنبال نشانگر [*] باشید).
Kernel را مجدداً راه‌اندازی کرده و همه سلول‌ها را اجرا کنید: Kernel → Restart & Run All
کنسول مرورگر را برای خطاهای JavaScript بررسی کنید (F12).

مشکل: نمی‌توان سلول‌ها را اجرا کرد - هنگام کلیک روی "Run" هیچ پاسخی دریافت نمی‌شود.

راه‌حل:

بررسی کنید آیا سرور Jupyter هنوز در ترمینال در حال اجرا است.
صفحه مرورگر را تازه کنید.
Notebook را ببندید و دوباره باز کنید.
سرور Jupyter را مجدداً راه‌اندازی کنید.

مشکلات بسته‌های Python

خطاهای Import

مشکل: ModuleNotFoundError: No module named 'sklearn'

راه‌حل:

pip install scikit-learn

# Common ML packages for this course
pip install scikit-learn pandas numpy matplotlib seaborn

مشکل: ImportError: cannot import name 'X' from 'sklearn'

راه‌حل:

# Update scikit-learn to latest version
pip install --upgrade scikit-learn

# Check version
python -c "import sklearn; print(sklearn.__version__)"

تداخل نسخه‌ها

مشکل: خطاهای ناسازگاری نسخه بسته‌ها

راه‌حل:

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

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

# If specific version needed
pip install scikit-learn==1.3.0

مشکل: pip install با خطاهای دسترسی شکست می‌خورد.

راه‌حل:

# Install for current user only
pip install --user package-name

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

مشکلات بارگذاری داده‌ها

مشکل: FileNotFoundError هنگام بارگذاری فایل‌های CSV

راه‌حل:

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

# Use relative paths from notebook location
df = pd.read_csv('../../data/filename.csv')

# Or use absolute paths
df = pd.read_csv('/full/path/to/data/filename.csv')

مشکلات محیط R

نصب بسته‌ها

مشکل: نصب بسته‌ها با خطاهای کامپایل شکست می‌خورد.

راه‌حل:

# Install binary version (Windows/macOS)
install.packages("package-name", type = "binary")

# Update R to latest version if packages require it
# Check R version
R.version.string

# Install system dependencies (Linux)
# For Ubuntu/Debian, in terminal:
# sudo apt-get install r-base-dev

مشکل: tidyverse نصب نمی‌شود.

راه‌حل:

# Install dependencies first
install.packages(c("rlang", "vctrs", "pillar"))

# Then install tidyverse
install.packages("tidyverse")

# Or install components individually
install.packages(c("dplyr", "ggplot2", "tidyr", "readr"))

مشکلات RMarkdown

مشکل: RMarkdown رندر نمی‌شود.

راه‌حل:

# Install/update rmarkdown
install.packages("rmarkdown")

# Install pandoc if needed
install.packages("pandoc")

# For PDF output, install tinytex
install.packages("tinytex")
tinytex::install_tinytex()

مشکلات اپلیکیشن آزمون

ساخت و نصب

مشکل: 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 fails, try with legacy peer deps
npm install --legacy-peer-deps

مشکل: پورت 8080 قبلاً استفاده شده است.

راه‌حل:

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

# Or find and kill process using port 8080
# On Linux/macOS:
lsof -ti:8080 | xargs kill -9

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

خطاهای ساخت

مشکل: npm run build شکست می‌خورد.

راه‌حل:

# Check Node.js version (should be 14+)
node --version

# Update Node.js if needed
# Then clean install
rm -rf node_modules package-lock.json
npm install
npm run build

مشکل: خطاهای linting مانع ساخت می‌شوند.

راه‌حل:

# Fix auto-fixable issues
npm run lint -- --fix

# Or temporarily disable linting in build
# (not recommended for production)

مشکلات داده و مسیر فایل

مشکلات مسیر

مشکل: فایل‌های داده هنگام اجرای Notebook‌ها پیدا نمی‌شوند.

راه‌حل:

همیشه Notebook‌ها را از دایرکتوری حاوی آن‌ها اجرا کنید.
```
cd /path/to/lesson/folder
jupyter notebook
```

مسیرهای نسبی در کد را بررسی کنید.

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

# Not from your terminal location

در صورت نیاز از مسیرهای مطلق استفاده کنید.

import os
base_path = os.path.dirname(os.path.abspath(__file__))
data_path = os.path.join(base_path, 'data', 'filename.csv')

فایل‌های داده گم شده

مشکل: فایل‌های مجموعه داده گم شده‌اند.

راه‌حل:

بررسی کنید آیا داده‌ها باید در مخزن باشند - بیشتر مجموعه داده‌ها شامل هستند.
برخی درس‌ها ممکن است نیاز به دانلود داده داشته باشند - README درس را بررسی کنید.
مطمئن شوید آخرین تغییرات را کشیده‌اید:
```
git pull origin main
```

پیام‌های خطای رایج

خطاهای حافظه

خطا: MemoryError یا Kernel هنگام پردازش داده‌ها از کار می‌افتد.

راه‌حل:

# Load data in chunks
for chunk in pd.read_csv('large_file.csv', chunksize=10000):
    process(chunk)

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

# Free memory when done
del large_dataframe
import gc
gc.collect()

هشدارهای همگرایی

هشدار: ConvergenceWarning: Maximum number of iterations reached

راه‌حل:

from sklearn.linear_model import LogisticRegression

# Increase max iterations
model = LogisticRegression(max_iter=1000)

# Or scale your features first
from sklearn.preprocessing import StandardScaler
scaler = StandardScaler()
X_scaled = scaler.fit_transform(X)

مشکلات رسم نمودار

مشکل: نمودارها در Jupyter نمایش داده نمی‌شوند.

راه‌حل:

# Enable inline plotting
%matplotlib inline

# Import pyplot
import matplotlib.pyplot as plt

# Show plot explicitly
plt.plot(data)
plt.show()

مشکل: نمودارهای Seaborn متفاوت به نظر می‌رسند یا خطا می‌دهند.

راه‌حل:

import warnings
warnings.filterwarnings('ignore', category=UserWarning)

# Update to compatible version
# pip install --upgrade seaborn matplotlib

خطاهای Unicode/Encoding

مشکل: UnicodeDecodeError هنگام خواندن فایل‌ها

راه‌حل:

# Specify encoding explicitly
df = pd.read_csv('file.csv', encoding='utf-8')

# Or try different encoding
df = pd.read_csv('file.csv', encoding='latin-1')

# For errors='ignore' to skip problematic characters
df = pd.read_csv('file.csv', encoding='utf-8', errors='ignore')

مشکلات عملکرد

اجرای کند Notebook‌ها

مشکل: Notebook‌ها بسیار کند اجرا می‌شوند.

راه‌حل:

Kernel را برای آزاد کردن حافظه مجدداً راه‌اندازی کنید: Kernel → Restart
Notebook‌های استفاده نشده را ببندید تا منابع آزاد شوند.
از نمونه‌های داده کوچک‌تر برای آزمایش استفاده کنید:
```
# Work with subset during development
df_sample = df.sample(n=1000)
```

کد خود را پروفایل کنید تا نقاط ضعف را پیدا کنید:

%time operation()  # Time single operation
%timeit operation()  # Time with multiple runs

استفاده زیاد از حافظه

مشکل: سیستم حافظه کم می‌آورد.

راه‌حل:

# Check memory usage
df.info(memory_usage='deep')

# Optimize data types
df['column'] = df['column'].astype('int32')  # Instead of int64

# Drop unnecessary columns
df = df[['col1', 'col2']]  # Keep only needed columns

# Process in batches
for batch in np.array_split(df, 10):
    process(batch)

محیط و تنظیمات

مشکلات محیط مجازی

مشکل: محیط مجازی فعال نمی‌شود.

راه‌حل:

# Windows
python -m venv venv
venv\Scripts\activate.bat

# macOS/Linux
python3 -m venv venv
source venv/bin/activate

# Check if activated (should show venv name in prompt)
which python  # Should point to venv python

مشکل: بسته‌ها نصب شده‌اند اما در Notebook پیدا نمی‌شوند.

راه‌حل:

# Ensure notebook uses the correct kernel
# Install ipykernel in your venv
pip install ipykernel
python -m ipykernel install --user --name=ml-env --display-name="Python (ml-env)"

# In Jupyter: Kernel → Change Kernel → Python (ml-env)

مشکلات Git

مشکل: نمی‌توان آخرین تغییرات را کشید - تداخل‌های ادغام

راه‌حل:

# Stash your changes
git stash

# Pull latest
git pull origin main

# Reapply your changes
git stash pop

# If conflicts, resolve manually or:
git checkout --theirs path/to/file  # Take remote version
git checkout --ours path/to/file    # Keep your version

یکپارچگی VS Code

مشکل: Notebook‌های Jupyter در VS Code باز نمی‌شوند.

راه‌حل:

افزونه Python را در VS Code نصب کنید.
افزونه Jupyter را در VS Code نصب کنید.
مفسر صحیح Python را انتخاب کنید: Ctrl+Shift+P → "Python: Select Interpreter"
VS Code را مجدداً راه‌اندازی کنید.

منابع اضافی

بحث‌های دیسکورد: سوالات بپرسید و راه‌حل‌ها را در کانال #ml-for-beginners به اشتراک بگذارید
Microsoft Learn: ماژول‌های یادگیری ماشین برای مبتدیان
آموزش‌های ویدیویی: لیست پخش یوتیوب
ردیاب مشکلات: گزارش خطاها

هنوز مشکل دارید؟

اگر راه‌حل‌های بالا را امتحان کرده‌اید و هنوز مشکل دارید:

مشکلات موجود را جستجو کنید: مشکلات GitHub
بحث‌ها را در دیسکورد بررسی کنید: بحث‌های دیسکورد
یک مشکل جدید باز کنید: شامل موارد زیر باشد:
- سیستم عامل و نسخه شما
- نسخه Python/R
- پیام خطا (traceback کامل)
- مراحل بازتولید مشکل
- آنچه قبلاً امتحان کرده‌اید

ما اینجا هستیم تا کمک کنیم! 🚀

سلب مسئولیت:
این سند با استفاده از سرویس ترجمه هوش مصنوعی Co-op Translator ترجمه شده است. در حالی که ما تلاش می‌کنیم دقت را حفظ کنیم، لطفاً توجه داشته باشید که ترجمه‌های خودکار ممکن است شامل خطاها یا نادرستی‌ها باشند. سند اصلی به زبان اصلی آن باید به عنوان منبع معتبر در نظر گرفته شود. برای اطلاعات حساس، توصیه می‌شود از ترجمه انسانی حرفه‌ای استفاده کنید. ما مسئولیتی در قبال سوء تفاهم‌ها یا تفسیرهای نادرست ناشی از استفاده از این ترجمه نداریم.

17 KiB Raw Blame History Unescape Escape

راهنمای رفع مشکلات

فهرست مطالب

مشکلات نصب

نصب Python

نصب Jupyter

نصب R

مشکلات Jupyter Notebook

مشکلات Kernel

مشکلات سلول‌های Notebook

مشکلات بسته‌های Python

خطاهای Import

تداخل نسخه‌ها

مشکلات بارگذاری داده‌ها

مشکلات محیط R

نصب بسته‌ها

مشکلات RMarkdown

مشکلات اپلیکیشن آزمون

ساخت و نصب

خطاهای ساخت

مشکلات داده و مسیر فایل

مشکلات مسیر

فایل‌های داده گم شده

پیام‌های خطای رایج

خطاهای حافظه

هشدارهای همگرایی

مشکلات رسم نمودار

خطاهای Unicode/Encoding

مشکلات عملکرد

اجرای کند Notebook‌ها

استفاده زیاد از حافظه

محیط و تنظیمات

مشکلات محیط مجازی

مشکلات Git

یکپارچگی VS Code

منابع اضافی

هنوز مشکل دارید؟

17 KiB

Raw Blame History Unescape Escape