Data-Science-For-Beginners/translations/km/TROUBLESHOOTING.md

មគ្គុទេសក៍ដោះស្រាយបញ្ហា

មគ្គុទេសក៍នេះផ្តល់ដំណោះស្រាយចំពោះបញ្ហាទូទៅដែលអ្នកអាចជួបប្រទៈនៅពេលធ្វើការជាមួយមេរៀន Data Science សម្រាប់អ្នកដើម។

តារាងមាតិកា

• បញ្ហា Python និង Jupyter
• បញ្ហា Package និង Dependency
• បញ្ហា Jupyter Notebook
• បញ្ហាកម្មវិធី Quiz
• បញ្ហា Git និង GitHub
• បញ្ហា Docsify Documentation
• បញ្ហារបស់ Data និង File
• បញ្ហាសមត្ថភាព
• ការទទួលបានជំនួយបន្ថែម

បញ្ហា Python និង Jupyter

មិនឃើញ Python ឬ ជំនាន់មិនត្រឹមត្រូវ

បញ្ហា: python: command not found ឬ ជំនាន់ Python មិនត្រឹមត្រូវ

ដំណោះស្រាយ:

# ពិនិត្យ​ប្រភេទ Python
python --version
python3 --version

# បើ python3 បានដំឡើងជា 'python3', បង្កើត alias
# លើ macOS/Linux, បន្ថែមទៅ ~/.bashrc ឬ ~/.zshrc:
alias python=python3
alias pip=pip3

# ឬ​ប្រើ python3 យ៉ាងបញ្ជាក់
python3 -m pip install jupyter

ដំណោះស្រាយសម្រាប់ Windows:

1. តម្លើង Python ពី python.org
2. នៅពេលតម្លើង សូមពិនិត្យ "Add Python to PATH"
3. បើកបញ្ចាញបញ្ជា/Terminal ឡើងវិញ

បញ្ហាចាប់ផ្តើម Virtual Environment

បញ្ហា: Virtual environment មិនអាចចាប់ផ្តើមបាន

ដំណោះស្រាយ:

Windows:

# ប្រសិនបើអ្នកទទួលមានកំហុសគោលនយោបាយអនុវត្ត
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# បន្ទាប់មកបើកអ្នក
venv\Scripts\activate

macOS/Linux:

# បញ្ចាក់ឲ្យបានថា script បើកដំណើរការអាចប្រតិបត្តិបាន
chmod +x venv/bin/activate

# បន្ទាប់មកបើកដំណើរការ
source venv/bin/activate

ตรวจสอบการเปิดใช้งาน:

# បញ្ជាក់របស់អ្នកគួរតែបង្ហាញ (venv)
# ពិនិត្យទីតាំង Python
which python  # គួរតែចង្អុលទៅ venv

បញ្ហា Kernel Jupyter

បញ្ហា: "Kernel not found" ឬ "Kernel keeps dying"

ដំណោះស្រាយ:

# ដំឡើង kernel ថ្មី
python -m ipykernel install --user --name=datascience --display-name="Python (Data Science)"

# ឬប្រើ kernel លំនាំដើម
python -m ipykernel install --user

# ចាប់ផ្ដើម Jupyter ថ្មីម្តង
jupyter notebook

បញ្ហា: ជំនាន់ Python មិនត្រឹមត្រូវនៅក្នុង Jupyter

ដំណោះស្រាយ:

# តំឡើង Jupyter នៅក្នុងបរិបទវីរុសរបស់អ្នក
source venv/bin/activate  # បើកដំណើរការជាមុន
pip install jupyter ipykernel

# ចុះឈ្មោះកណ្តុរពហុ
python -m ipykernel install --user --name=venv --display-name="Python (venv)"

# នៅក្នុង Jupyter, ជ្រើស Kernel -> ប្ដូរកណ្តុរពហុ -> Python (venv)

បញ្ហា Package និង Dependency

បញ្ហា Import

បញ្ហា: ModuleNotFoundError: No module named 'pandas' (ឬ package ផ្សេង)

ដំណោះស្រាយ:

# ប្រាកដថាបរិយាកាសពិតត្រូវបានបើកបរ
source venv/bin/activate  # macOS/Linux
venv\Scripts\activate     # វីនដូ

# ដំឡើងផ្នែកបាក់កេសដែលខ្វះ
pip install pandas

# ដំឡើងផ្នែកបាក់កេសទូទៅទាំងអស់
pip install jupyter pandas numpy matplotlib seaborn scikit-learn

# បញ្ជាក់ការដំឡើង
python -c "import pandas; print(pandas.__version__)"

បិទការតម្លើង Pip

បញ្ហា: pip install បរាជ័យដោយសារមានបញ្ហារបស់ការអនុញ្ញាត

ដំណោះស្រាយ:

# ប្រើទង់ដង់ --user
pip install --user package-name

# ឬប្រើបរិយាកាសវត្ថុសូរ (ណែនាំ)
python -m venv venv
source venv/bin/activate
pip install package-name

បញ្ហា: pip install បរាជ័យដោយសារត្រូវបាន SSL certificate

ដំណោះស្រាយ:

# បន្ទាន់សម័យ pip ជាមុនសិន
python -m pip install --upgrade pip

# សាកល្បងដំឡើងជាមួយម៉ាស៊ីនឧបត្ថម្ភដែលទុកចិត្តបាន (វិធីជួយបណ្តោះអាសន្ន)
pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org package-name

បញ្ហា Package មានជំនាន់ផ្ទុះ

បញ្ហា: ជំនាន់ package មិនត្រូវគ្នា

ដំណោះស្រាយ:

# បង្កើតបរិបទវើឌឺជាទំនើប
python -m venv venv-new
source venv-new/bin/activate  # ឬ venv-new\Scripts\activate នៅលើប្រព័ន្ធប្រតិបត្តិការ Windows

# ដំឡើងកញ្ចប់ជាមួយនឹងកំណែជាក់លាក់ ប្រសិនបើចាំបាច់
pip install pandas==1.3.0
pip install numpy==1.21.0

# ឬអនុញ្ញាតឲ្យ pip បញ្ចេញទំនាក់ទំនងដែលត្រូវការ
pip install jupyter pandas numpy matplotlib seaborn scikit-learn

បញ្ហា Jupyter Notebook

Jupyter មិនចាប់ផ្តើម

បញ្ហា: ពាក្យបញ្ជា jupyter notebook មិនឃើញ

ដំណោះស្រាយ:

# ដំឡើង Jupyter
pip install jupyter

# ឬប្រើ python -m
python -m jupyter notebook

# បន្ថែមទៅ PATH ប្រសិនបើចាំបាច់ (macOS/Linux)
export PATH="$HOME/.local/bin:$PATH"

Notebook មិនផ្ទុក ឬ មិនរក្សាទុក

បញ្ហា: "Notebook failed to load" ឬ បញ្ហាក្នុងការរក្សាទុក

ដំណោះស្រាយ:

1. ពិនិត្យសិទ្ធិលើ File

# ត្រូវប្រាកដថាអ្នកមានសិទ្ធិសរសេរ
ls -l notebook.ipynb
chmod 644 notebook.ipynb  # ប្រសិនបើត្រូវការ

2. ពិនិត្យការខូចខាតនៅលើ File

# សាកល្បងបើកនៅកម្មវិធីកែសម្រួលអត្ថបទដើម្បីត្រួតពិនិត្យរចនាសម្ព័ន្ធ JSON
# បញ្ចូលមាតិកាទៅកាន់សៀវភៅកំណត់ត្រាថ្មី ប្រសិនបើខូចខាត

3. សម្អាត cache Jupyter

jupyter notebook --clear-cache

Cell មិនអាចសម្រឹងបាន

បញ្ហា: Cell ឈរនៅ "In [*]" ឬ ប្រើពេលយូរ

ដំណោះស្រាយ:

1. ដកចេញ kernel: ចុចប៊ូតុង "Interrupt" ឬចុច I, I
2. ចាប់ផ្តើម kernel ម្តងទៀត: របារទំព័រ Kernel → Restart
3. ពិនិត្យរក loop មិនចប់ ក្នុង code របស់អ្នក
4. សម្អាតចេញលទ្ធផល: Cell → All Output → Clear

ការបង្ហាញផ្ទាំងរេចតាមប្រព័ន្ធមិនបង្ហាញ

បញ្ហា: matplotlib បង្ហាញគូលនៅក្នុង notebook មិនបាន

ដំណោះស្រាយ:

# បន្ថែមពាក្យបញ្ជាមន្តអោយនៅកំពូលសៀវភៅកំណត់ត្រា
%matplotlib inline

import matplotlib.pyplot as plt

# បង្កើតផ្លុក
plt.plot([1, 2, 3, 4])
plt.show()  # បញ្ជាក់អោយហៅ show()

ជម្រើសផ្សេងសម្រាប់ផ្ទាំងរេចតាមប្រព័ន្ធអន្តរកម្ម:

%matplotlib notebook
# ឬ
%matplotlib widget

បញ្ហាកម្មវិធី Quiz

ការតម្លើង npm បរាជ័យ

បញ្ហា: មានកំហុសនៅពេល npm install

ដំណោះស្រាយ:

# សម្អាត cache npm
npm cache clean --force

# យក node_modules និង package-lock.json ចេញ
rm -rf node_modules package-lock.json

# ដំឡើងឡើងវិញ
npm install

# ប្រសិនបើនៅតែបរាជ័យ សូមសាកល្បងជាមួយ legacy peer deps
npm install --legacy-peer-deps

កម្មវិធី Quiz មិនចាប់ផ្តើម

បញ្ហា: npm run serve បរាជ័យ

ដំណោះស្រាយ:

# ពិនិត្យកំណែ Node.js
node --version  # គួរតែជាកំណែ 12.x ឬខ្ពស់ជាងនេះ

# ដំឡើងតម្រូវការឡើងវិញ
cd quiz-app
rm -rf node_modules package-lock.json
npm install

# សាកល្បងច្រកផ្សេងទៀត
npm run serve -- --port 8081

ច្រក (Port) មានការប្រើប្រាស់រួចហើយ

បញ្ហា: "Port 8080 is already in use"

ដំណោះស្រាយ:

# ស្វែងរក និងបាញ់បណ្តាលដំណើរការនៅលើព្រលង់ 8080
# macOS/Linux:
lsof -ti:8080 | xargs kill -9

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

# ឬប្រើព្រលង់ផ្សេងទៀត
npm run serve -- --port 8081

កម្មវិធី Quiz មិនផ្ទុក ឬ ទំព័របង្ហាញទទេ

បញ្ហា: កម្មវិធី Quiz ផ្ទុកប៉ុន្តែនៅទំព័រទទេ

ដំណោះស្រាយ:

1. ពិនិត្យ console របស់ browser សម្រាប់កំហុស (F12)
2. សម្អាត cache និង cookies របស់ browser
3. សាក browser ផ្សេងទៀត
4. ធានាបានថា JavaScript បានបើក
5. ពិនិត្យថាមិនមានកម្មវិធីរារាំងផ្សាយពាណិជ្ជកម្ម (ad blocker) រារាំង

# សាងសង់កម្មវិធីឡើងវិញ
npm run build
npm run serve

បញ្ហា Git និង GitHub

មិនកំណត់ស្គាល់ git

បញ្ហា: git: command not found

ដំណោះស្រាយ:

Windows:

• តម្លើង Git ពី git-scm.com
• បើក terminal ម្តងទៀតបន្ទាប់ពីតម្លើង

macOS:

ចំណាំ: ប្រសិនបើអ្នកមិនមាន Homebrew ត្រូវធ្វើតាមការណែនាំនៅ https://brew.sh/ ដើម្បីតម្លើងជាមុន។

# ដំឡើងតាមរយៈ Homebrew
brew install git

# ឬដំឡើងឧបករណ៍បញ្ជារបន្ទាត់ Xcode
xcode-select --install

Linux:

sudo apt-get install git  # Debian/Ubuntu
sudo dnf install git      # Fedora

ការចម្លង clone បរាជ័យ

បញ្ហា: git clone បរាជ័យដោយសារការផ្ទៀងផ្ទាត់មិនបាន

ដំណោះស្រាយ:

# ប្រើ URL HTTPS
git clone https://github.com/microsoft/Data-Science-For-Beginners.git

# ប្រសិនបើអ្នកបានបើក 2FA នៅលើ GitHub សូមប្រើ Personal Access Token
# បង្កើត token នៅ: https://github.com/settings/tokens
# ប្រើ token ជាពាក្យសម្ងាត់នៅពេលដែលត្រូវបានស្នើសុំ

សិទ្ធិដាក់បដិសេធ (publickey)

បញ្ហា: ការផ្ទៀងផ្ទាត់សោ SSH បរាជ័យ

ដំណោះស្រាយ:

# បង្កើតកូនសោ SSH
ssh-keygen -t ed25519 -C "your_email@example.com"

# បញ្ចូលកូនសោទៅ ssh-agent
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

# បន្ថែមកូនសោសាធារណៈទៅ GitHub
# ចម្លងកូនសោៈ cat ~/.ssh/id_ed25519.pub
# បន្ថែមនៅ៖ https://github.com/settings/keys

បញ្ហា Docsify Documentation

ពាក្យបញ្ជា Docsify មិនឃើញ

បញ្ហា: docsify: command not found

ដំណោះស្រាយ:

# ដំឡើងជាសកល
npm install -g docsify-cli

# ប្រសិនបើមានកំហុសសិទ្ធិលើ macOS/Linux
sudo npm install -g docsify-cli

# ផ្ទៀងផ្ទាត់ការដំឡើង
docsify --version

# ប្រសិនបើនៅតែមិនបានរកឃើញ ចូរបន្ថែមផ្លូវ npm ជាសកល
# រកផ្លូវ npm ជាសកល
npm config get prefix

# បន្ថែមទៅ PATH (បន្ថែមចូលក្នុង ~/.bashrc ឬ ~/.zshrc)
export PATH="$PATH:/usr/local/bin"

ការរចនាឯកសារ មិនផ្ទុក

បញ្ហា: Docsify ប្រើប្រាស់បាន ប៉ុន្តែមាតិកាមិនផ្ទុក

ដំណោះស្រាយ:

# ការធានាថាអ្នកនៅក្នុងឫសកន្លែងបញ្ជូន
cd Data-Science-For-Beginners

# ពិនិត្យមើលសម្រាប់ index.html
ls index.html

# បម្រើជាមួយព័រត់ជាក់លាក់
docsify serve --port 3000

# ពិនិត្យមើលកុងសូលកម្មវិធីរុករកសម្រាប់កំហុស (F12)

រូបភាពមិនបង្ហាញ

បញ្ហា: រូបភាពបង្ហាញការខូចខាត

ដំណោះស្រាយ:

1. ពិនិត្យវិថីរូបភាពគឺជាវិថីនិបាត
2. ធានាថារូបភាពមាននៅក្នុងធរណីមួយ
3. សម្អាត cache របស់ browser
4. ពិនិត្យឱ្យប្រាកដថាគ្មានកំហុសនៅក្នុងបន្ថែមទីបញ្ចូលឯកសារ (case-sensitive នៅលើប្រព័ន្ធខ្លះ)

បញ្ហារបស់ Data និង File

កំហុសមិនឃើញ File

បញ្ហា: FileNotFoundError ពេលដំណើរការទិន្នន័យ

ដំណោះស្រាយ:

import os

# ពិនិត្យថាតើថតកំពុងធ្វើការបច្ចុប្បន្ន
print(os.getcwd())

# ប្រើផ្លូវដាច់ដោយឡែក
data_path = os.path.join(os.getcwd(), 'data', 'filename.csv')
df = pd.read_csv(data_path)

# ឬប្រើផ្លូវទាក់ទងពីទីតាំងសៀវភៅសរសេរ
df = pd.read_csv('../data/filename.csv')

# ផ្ទៀងផ្ទាត់ឯកសារមាននៅ
print(os.path.exists('data/filename.csv'))

កំហុសអាន CSV

បញ្ហា: កំហុសនៅពេលអានឯកសារ CSV

ដំណោះស្រាយ:

import pandas as pd

# ព្យាយាមការបង្កូតផ្សេងៗ
df = pd.read_csv('file.csv', encoding='utf-8')
# ឬ
df = pd.read_csv('file.csv', encoding='latin-1')
# ឬ
df = pd.read_csv('file.csv', encoding='ISO-8859-1')

# គ្រប់គ្រងតម្លៃដែលបាត់បង់
df = pd.read_csv('file.csv', na_values=['NA', 'N/A', ''])

# បញ្ជាក់អថេរបំបែក ប្រសិនបើមិនមែនជាក្បៀសកុម្ភៈ
df = pd.read_csv('file.csv', delimiter=';')

កំហុសម៉ឺម៉ូរីជាមួយឯកសារច្រើន

បញ្ហា: MemoryError ពេលដំណើរការឯកសារធំ

ដំណោះស្រាយ:

# អានជាផ្នែកៗ
chunk_size = 10000
chunks = []
for chunk in pd.read_csv('large_file.csv', chunksize=chunk_size):
    # ដំណើរការផ្នែក
    chunks.append(chunk)
df = pd.concat(chunks)

# ឬអានតែជួរឈរពិសេសប៉ុណ្ណោះ
df = pd.read_csv('file.csv', usecols=['col1', 'col2'])

# ប្រើប្រភេទទិន្នន័យដែលមានប្រសិទ្ធភាពច្រើនជាង
df = pd.read_csv('file.csv', dtype={'column_name': 'int32'})

បញ្ហាសមត្ថភាព

សមត្ថភាព Notebook យឺត

បញ្ហា: Notebook ធ្វើការយឺតខ្លាំង

ដំណោះស្រាយ:

1. ចាប់ផ្តើម kernel ម្តងទៀត និងសម្អាតលទ្ធផល

   • Kernel → Restart & Clear Output

2. បិទ notebooks ដែលមិនប្រើប្រាស់

3. បង្កើនប្រសិទ្ធភាព code:

# ប្រើប្រតិបត្តិការវិចទ័រជំនួសការលោត
# អាក្រក់:
result = []
for x in data:
    result.append(x * 2)

# ល្អ:
result = data * 2  # វិចទ័រកម្ម NumPy/Pandas

4. យកតែទិន្នន័យគំរូពី dataset ធំៗ:

# ធ្វើការជាមួយ​គំរូក្នុងអំឡុងពេលអភិវឌ្ឍន៍
df_sample = df.sample(n=1000)  # ឬ df.head(1000)

Browser ធ្លាក់ឬមិនចាប់ផ្តើមបាន

បញ្ហា: Browser ធ្លាក់ ឬមិនប្រតិបត្តិការក្នុងលក្ខខណ្ឌល្អ

ដំណោះស្រាយ:

1. បិទផ្ទាំងបើកមិនប្រើប្រាស់
2. សម្អាត cache របស់ browser
3. បង្កើនម៉ឺម៉ូរី browser (Chrome: chrome://settings/system)
4. ប្រើ JupyterLab ជំនួស:

pip install jupyterlab
jupyter lab

ការទទួលបានជំនួយបន្ថែម

មុនសុំជំនួយ

1. សូមពិនិត្យមើលមគ្គុទេសក៍ដោះស្រាយបញ្ហានេះ
2. ស្វែងរកនៅ GitHub Issues
3. ពិនិត្យឯកសារ INSTALLATION.md និង USAGE.md
4. សាកសួរពាក្យកំហុសនៅលើអ៊ីនធើណេត

របៀបសុំជំនួយ

ពេលបង្កើតបញ្ហា ឬសុំជំនួយ សូមបញ្ចូល:

1. ប្រព័ន្ធប្រតិបត្តិការ: Windows, macOS, ឬ Linux (ចុះដឹងប្រភេទ)
2. ជំនាន់ Python: រត់ python --version
3. សារកំហុស: ចម្លងសារបញ្ហាពេញលេញ
4. ជំហានដែលបានធ្វើ: ការប្រតិបត្តិមុនកើតកំហុស
5. អ្វីដែលបានសាកល្បង: ដំណោះស្រាយដែលអ្នកបានព្យាយាមរួច

ឧទាហរណ៍:

**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: ចូលរួមសហគមន៍
• Discussions: ការ​ពិភាក្សា GitHub
• Microsoft Learn: កន្លែងសួរសំណួរ Q&A

ឯកសារពាក់ព័ន្ធ

• INSTALLATION.md - មគ្គុទេសក៍ដំឡើង
• USAGE.md - របៀបប្រើប្រាស់មេរៀន
• CONTRIBUTING.md - របៀបចូលរួម
• README.md - ពត៌មានសង្ខេបគម្រោង

---

ការបដិសេធ៖ ឯកសារនេះត្រូវបានបកប្រែដោយប្រើសេវាកម្មបកប្រែ AI Co-op Translator។ បើទោះបីយើងខិតខំកទ្រឹងភាពត្រឹមត្រូវ ក៏ដោយ សូមជ្រាបថាការបកប្រែដោយស្វ័យប្រវត្តិអាចមានកំហុសឬមិនត្រឹមត្រូវ។ ឯកសារដើមជាភាសា​ដើមគួរត្រូវបានគិតថាជាឯកសារដែលមានភាពអប់រំខ្ពស់បំផុត។ សម្រាប់ព័ត៌មានសំខាន់ៗ សូមណែនាំឱ្យប្រើការបកប្រែដោយអ្នកជំនាញមនុស្សវិជ្ជាជីវៈ។ យើងមិនទទួលខុសត្រូវចំពោះការយល់ច្រឡំនឹងឬការបោះពុម្ពអត់ត្រឹមត្រូវណាមួយដែលកើតឡើងពីការប្រើប្រាស់ការបកប្រែនេះឡើយ។