این راهنما به شما کمک میکند مشکلات رایج هنگام کار با دوره آموزشی یادگیری ماشین برای مبتدیان را حل کنید. اگر راهحلی در اینجا پیدا نکردید، لطفاً به بحثهای دیسکورد مراجعه کنید یا یک مشکل جدید باز کنید.
- مشکلات نصب
- مشکلات Jupyter Notebook
- مشکلات بستههای Python
- مشکلات محیط R
- مشکلات اپلیکیشن آزمون
- مشکلات داده و مسیر فایل
- پیامهای خطای رایج
- مشکلات عملکرد
- محیط و تنظیمات
مشکل: 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: 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 نصب نمیشوند.
راهحل:
# 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)مشکل: 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مشکل: سلولها اجرا میشوند اما خروجی نشان داده نمیشود.
راهحل:
- بررسی کنید آیا سلول هنوز در حال اجرا است (به دنبال نشانگر
[*]باشید). - Kernel را مجدداً راهاندازی کرده و همه سلولها را اجرا کنید:
Kernel → Restart & Run All - کنسول مرورگر را برای خطاهای JavaScript بررسی کنید (F12).
مشکل: نمیتوان سلولها را اجرا کرد - هنگام کلیک روی "Run" هیچ پاسخی دریافت نمیشود.
راهحل:
- بررسی کنید آیا سرور Jupyter هنوز در ترمینال در حال اجرا است.
- صفحه مرورگر را تازه کنید.
- Notebook را ببندید و دوباره باز کنید.
- سرور Jupyter را مجدداً راهاندازی کنید.
مشکل: 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')مشکل: نصب بستهها با خطاهای کامپایل شکست میخورد.
راهحل:
# 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 رندر نمیشود.
راهحل:
# 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مشکل: 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ها بسیار کند اجرا میشوند.
راهحل:
- 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)مشکل: نمیتوان آخرین تغییرات را کشید - تداخلهای ادغام
راهحل:
# 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مشکل: 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 ترجمه شده است. در حالی که ما تلاش میکنیم دقت را حفظ کنیم، لطفاً توجه داشته باشید که ترجمههای خودکار ممکن است شامل خطاها یا نادرستیها باشند. سند اصلی به زبان اصلی آن باید به عنوان منبع معتبر در نظر گرفته شود. برای اطلاعات حساس، توصیه میشود از ترجمه انسانی حرفهای استفاده کنید. ما مسئولیتی در قبال سوء تفاهمها یا تفسیرهای نادرست ناشی از استفاده از این ترجمه نداریم.