រៀបចំម៉ាស៊ីន VS Code, Python, VENV និងរចនាសម្ព័ន្ធកម្មវិធី PyQt6

១. គោលបំណងនៃមេរៀន

ក្រោយបញ្ចប់មេរៀននេះ អ្នកសិក្សាអាចរៀបចំបរិស្ថានសម្រាប់អភិវឌ្ឍកម្មវិធី PyQt6 បានត្រឹមត្រូវ ទោះប្រើ Windows, macOS ឬ Linux ក៏ដោយ។

អ្នកសិក្សានឹងអាច៖

• បែងចែកតួនាទីរបស់ VS Code, Python Extension និង Python Interpreter បានត្រឹមត្រូវ។
• ដំឡើង និងផ្ទៀងផ្ទាត់ Python និង VS Code លើប្រព័ន្ធប្រតិបត្តិការទាំងបី។
• បង្កើតបរិស្ថាននិម្មិត (Virtual Environment ឬ VENV) តាមជម្រើសសំខាន់ៗក្នុង VS Code។
• ជ្រើស Python Interpreter ឱ្យត្រូវនឹងគម្រោង។
• ធ្វើឱ្យ Terminal ប្រើបរិស្ថាននិម្មិតបានត្រឹមត្រូវ។
• ដំឡើង PyQt6 និងសាកល្បងកម្មវិធី GUI ដំបូង។
• រៀបចំ Folder និង Module សម្រាប់លំហាត់តូច និងគម្រោងឆមាស។
• រៀបចំ requirements.txt, .gitignore និង VS Code Workspace Settings។
• ដោះស្រាយបញ្ហាទូទៅពាក់ព័ន្ធនឹង Python, VENV និង PyQt6។

ចំណេះដឹងដែលគួរមានជាមុន

មុនចាប់ផ្ដើមមេរៀននេះ អ្នកសិក្សាគួរយល់ដឹងអំពី៖

• អញ្ញតិ ឬអថេរ (Variable)
• ប្រភេទទិន្នន័យ
• ប្រមាណវិធី
• លក្ខខណ្ឌ
• រង្វិលជុំ
• Function
• List និង Dictionary
• Class មូលដ្ឋាន
• ការនាំចូល Module
• ការប្រើ Terminal ឬ Command Prompt មូលដ្ឋាន

រូបភាពទី១៖ រូបបង្ហាញលំហូរ Python Console → Python + PyQt6 → Desktop GUI Application។

---

២. ស្គាល់ឧបករណ៍សំខាន់ៗ

កំហុសដែលអ្នកចាប់ផ្ដើមជួបញឹកញាប់ គឺគិតថាក្រោយដំឡើង VS Code រួច មានន័យថា Python ក៏ត្រូវបានដំឡើងរួចដែរ។ តាមពិត VS Code និង Python គឺជាកម្មវិធីដាច់ពីគ្នា។

អាចយល់ពីទំនាក់ទំនងនេះតាមលំហូរខាងក្រោម៖

អ្នកសិក្សា → VS Code → Python Extension → Python Interpreter → PyQt6 Application

រូបភាពទី២៖ រូបបង្ហាញ VS Code, Python Extension និង Python Interpreter ធ្វើការភ្ជាប់គ្នា។ អក្សរក្នុងរូបអាចប្រើត្រឹម “VS Code”, “Python Extension” និង “Python Interpreter”។

---

៣. ហេតុអ្វីត្រូវប្រើ VENV?

VENV ជាពាក្យកាត់របស់ Virtual Environment ដែលមានន័យថា «បរិស្ថាននិម្មិត»។ វាបង្កើតតំបន់ដាច់ដោយឡែកមួយសម្រាប់រក្សាទុក Python Interpreter និង Package របស់គម្រោងនីមួយៗ។

ឧទាហរណ៍៖

• Project A ប្រើ PyQt6 ជំនាន់មួយ។
• Project B អាចប្រើ PyQt6 ជំនាន់ផ្សេង។
• Project C អាចប្រើ Flask, NumPy ឬ Pandas ដោយមិនពាក់ព័ន្ធនឹង Project A និង B។

បើដំឡើង Package ទាំងអស់ចូលក្នុង System Python ដោយផ្ទាល់ Package អាចប៉ះទង្គិចគ្នា ឬបណ្ដាលឱ្យគម្រោងមួយដំណើរការ ប៉ុន្តែគម្រោងមួយទៀតមានបញ្ហា។

ការប្រើ VENV ផ្ដល់អត្ថប្រយោជន៍ដូចជា៖

• ញែក Package របស់គម្រោងនីមួយៗពីគ្នា។
• កាត់បន្ថយបញ្ហាជំនាន់ Package មិនត្រូវគ្នា។
• ងាយស្រួលផ្ទេរគម្រោងទៅម៉ាស៊ីនផ្សេង។
• ងាយស្រួលធ្វើការជាក្រុម។
• មិនប៉ះពាល់ System Python។
• អាចបង្កើតបរិស្ថានដើមឡើងវិញតាម requirements.txt។

---

៤. ស្តង់ដារសម្រាប់ថ្នាក់រៀន

ដើម្បីកាត់បន្ថយបញ្ហាបច្ចេកទេស គ្រូ និងនិស្សិតគួរឯកភាពលើស្តង់ដាររួមមួយ។

ស្តង់ដារបរិស្ថាន

• ប្រើ Python ជំនាន់តែមួយ ឬជំនាន់ស្របគ្នាទាំងថ្នាក់។
• ប្រើឈ្មោះបរិស្ថានដូចគ្នាគឺ .venv។
• បើកគម្រោងជា Folder ឬ Workspace ក្នុង VS Code។
• មិនគួរបើកតែឯកសារ .py មួយដាច់ដោយឡែក។
• ដំឡើង Package ទាំងអស់ក្នុង .venv របស់គម្រោង។
• ប្រើ python -m pip ជំនួសការប្រើ pip ដាច់ៗ។
• មិនត្រូវ Upload ឬ Commit Folder .venv ទៅក្នុង Git។

ស្តង់ដារឈ្មោះគម្រោង

ឈ្មោះ Folder គួរប្រើអក្សរឡាតាំង និងសញ្ញាគូសក្រោម។

ឧទាហរណ៍ល្អ៖

student_management_app
coffee_shop_management
library_management_system
employee_payroll_app

គួរជៀសវាង៖

My Project!
Project #1
កម្មវិធីសិស្ស
Python App 2026

ការប្រើដកឃ្លា អក្សរពិសេស ឬឈ្មោះវែងពេក អាចបង្កបញ្ហាជាមួយពាក្យបញ្ជា និងផ្លូវឯកសារ។

---

៥. រៀបចំម៉ាស៊ីនតាមប្រព័ន្ធប្រតិបត្តិការ

លំហូរការងារទូទៅសម្រាប់ប្រព័ន្ធប្រតិបត្តិការទាំងបីគឺ៖

Python → VS Code → Extensions → Project Workspace → VENV → PyQt6

រូបភាពទី៣៖ រូបប្រព័ន្ធប្រតិបត្តិការទាំងបី Windows, macOS និង Linux ដោយបង្ហាញលំហូរដំឡើងដូចគ្នា។

៥.១ ការរៀបចំលើ Windows 10/11

ជំហានទី១៖ ដំឡើង Python

ទាញយក Python ពីគេហទំព័រផ្លូវការ៖

https://www.python.org/downloads/windows/

សម្រាប់កុំព្យូទ័របច្ចុប្បន្ន គួរជ្រើសរើស Python ប្រភេទ 64-bit និងប្រើជំនាន់ដែលគ្រូបានកំណត់។

នៅពេលដំណើរការ Python Installer ត្រូវធីក៖

Add Python to PATH

បន្ទាប់មកចុច Install Now។

ជំហានទី២៖ ផ្ទៀងផ្ទាត់ Python

បើក Command Prompt ឬ PowerShell ហើយសាកល្បង៖

py --version
python --version
py -m pip --version
where python

បើ Python ត្រូវបានដំឡើងត្រឹមត្រូវ នោះ Terminal នឹងបង្ហាញលេខជំនាន់របស់ Python និង Pip។

បើពាក្យបញ្ជា python បើក Microsoft Store ឬរក Python មិនឃើញ សូមសាកប្រើ៖

py --version

បើ py ដំណើរការ អ្នកអាចប្រើ py សម្រាប់បង្កើត VENV។

ជំហានទី៣៖ ដំឡើង VS Code

ទាញយក VS Code ពី៖

https://code.visualstudio.com/

សម្រាប់អ្នកប្រើធម្មតា អាចជ្រើសរើស User Installer។ ក្រោយដំឡើងរួច សូមបិទ និងបើក Terminal ថ្មី។

ផ្ទៀងផ្ទាត់៖

code --version

---

៥.២ ការរៀបចំលើ macOS

ជំហានទី១៖ ដំឡើង Python

ទាញយក Python Universal Installer ពី៖

https://www.python.org/downloads/macos/

អ្នកដែលស្គាល់ Homebrew ក៏អាចប្រើ៖

brew install python

ទោះជាយ៉ាងណា សម្រាប់ថ្នាក់រៀន គ្រូគួរកំណត់ឱ្យនិស្សិតប្រើវិធីតែមួយ ដើម្បីកាត់បន្ថយភាពខុសគ្នា។

ផ្ទៀងផ្ទាត់៖

python3 --version
python3 -m pip --version
which python3

មិនគួរប្រើ Python ដែល macOS រក្សាទុកសម្រាប់ប្រព័ន្ធ។ ត្រូវជ្រើស Python ដែលបានដំឡើងសម្រាប់ការអភិវឌ្ឍកម្មវិធី។

ជំហានទី២៖ ដំឡើង VS Code

• ទាញយកឯកសារ .dmg។
• បើកឯកសារ។
• អូស Visual Studio Code.app ទៅក្នុង Folder Applications។
• បើក VS Code។

ដើម្បីឱ្យ Terminal ស្គាល់ពាក្យបញ្ជា code៖

1. ចុច Cmd+Shift+P។
2. ស្វែងរក Shell Command: Install 'code' command in PATH។
3. ចុច Enter។
4. បិទ និងបើក Terminal ថ្មី។

ផ្ទៀងផ្ទាត់៖

code --version

---

៥.៣ ការរៀបចំលើ Linux

Ubuntu, Debian ឬ Linux Mint

sudo apt update
sudo apt install python3 python3-pip python3-venv
python3 --version
python3 -m pip --version

Fedora

sudo dnf install python3 python3-pip
python3 --version
python3 -m pip --version

ដំឡើង VS Code

VS Code អាចដំឡើងតាម .deb, .rpm ឬ Snap អាស្រ័យលើ Linux Distribution។

ឧទាហរណ៍ប្រើ Snap៖

sudo snap install --classic code
code --version

បើ PyQt6 បង្ហាញកំហុសពាក់ព័ន្ធនឹង Qt Platform Plugin ឬ Display ត្រូវពិនិត្យ System Library តាម Linux Distribution ដែលកំពុងប្រើ។

---

៦. ដំឡើង VS Code Extensions ចាំបាច់

បើកផ្ទាំង Extensions ក្នុង VS Code ដោយចុច៖

• Windows/Linux៖ Ctrl+Shift+X
• macOS៖ Cmd+Shift+X

ស្វែងរក និងដំឡើង Extension ខាងក្រោម៖

៦.១ Python

• ឈ្មោះ៖ Python
• Publisher៖ Microsoft

Extension នេះផ្ដល់មុខងារ៖

• Python IntelliSense
• Run Python File
• Debugging
• Testing
• Interpreter Selection
• Environment Integration

៦.២ Python Environments

• ឈ្មោះ៖ Python Environments
• Publisher៖ Microsoft

Extension នេះជួយ៖

• រកឃើញ Environment
• បង្កើត Environment
• ជ្រើស Interpreter
• គ្រប់គ្រង Package
• Refresh Environment
• គ្រប់គ្រង Environment តាម UI

៦.៣ Pylance

Pylance ជួយក្នុងការវិភាគកូដ និងផ្ដល់៖

• Auto-completion
• Type checking
• Error detection
• Code navigation
• Import suggestion

រូបភាពទី៤៖ Screenshot ផ្ទាំង Extensions ដោយបង្ហាញ Python និង Python Environments ដែលមាន Publisher ជា Microsoft។

នៅដំណាក់កាលដំបូង មិនចាំបាច់ដំឡើង Extension ច្រើនពេកទេ។ Extension សម្រាប់ Qt Designer, UI Preview ឬ Code Snippets គ្រាន់តែជាជម្រើសបន្ថែម មិនមែនជាតម្រូវការចាំបាច់សម្រាប់ដំណើរការ PyQt6 ទេ។

---

៧. បង្កើត Project Folder និងបើកជា Workspace

បង្កើត Folder ថ្មីមួយឈ្មោះ៖

pyqt6_student_app

អាចបង្កើតតាម File Explorer, Finder ឬ Terminal។

mkdir pyqt6_student_app
cd pyqt6_student_app
code .

សញ្ញាចុច . ក្នុងពាក្យបញ្ជា code . មានន័យថា បើក Folder បច្ចុប្បន្នជាមួយ VS Code។

បើពាក្យបញ្ជា code មិនដំណើរការ៖

1. បើក VS Code។
2. ចូលទៅ File។
3. ជ្រើស Open Folder។
4. ជ្រើស Folder pyqt6_student_app។

សញ្ញាដែលបញ្ជាក់ថាបើកត្រឹមត្រូវ គឺឈ្មោះ Project Folder បង្ហាញនៅផ្នែកខាងលើនៃ Explorer ក្នុង VS Code។

---

៨. ជម្រើសបង្កើត VENV ក្នុង VS Code

VS Code ផ្ដល់ជម្រើសសំខាន់ៗជាច្រើនសម្រាប់បង្កើត និងជ្រើស Python Environment។

៨.១ ជម្រើស A៖ Quick Create

នេះជាជម្រើសងាយស្រួលសម្រាប់អ្នកចាប់ផ្ដើម។

1. ចុចរូប Python នៅ Activity Bar។
2. បើកផ្នែក Environment Managers។
3. ចុចសញ្ញា +។
4. ជ្រើស Project Folder បើ VS Code សួរ។
5. រង់ចាំការបង្កើត Environment បញ្ចប់។
6. ពិនិត្យថា Folder .venv ត្រូវបានបង្កើត។

Quick Create ជាទូទៅនឹង៖

• ប្រើ VENV ជា Environment Manager។
• ជ្រើស Python Interpreter ដែលសមស្រប។
• បង្កើត Folder .venv។
• ជ្រើស Environment ថ្មីសម្រាប់ Project។
• ដំឡើង Dependency ពី requirements.txt ឬ pyproject.toml ប្រសិនបើមាន។

រូបភាពទី៥៖ Screenshot បង្ហាញ Python Sidebar → Environment Managers → សញ្ញា + → Quick Create។

---

៨.២ ជម្រើស B៖ Custom Create

Custom Create សមស្របសម្រាប់អ្នកដែលចង់គ្រប់គ្រងការបង្កើត Environment លម្អិតជាង Quick Create។

1. ចុច Ctrl+Shift+P លើ Windows/Linux ឬ Cmd+Shift+P លើ macOS។
2. វាយ Python: Create Environment។
3. ចុច Enter។
4. ជ្រើស Venv។
5. ជ្រើស Base Python Interpreter។
6. ជ្រើសឈ្មោះ .venv។
7. ជ្រើស Dependency File ប្រសិនបើមាន។
8. រង់ចាំការបង្កើតបញ្ចប់។

បើគម្រោងតម្រូវឱ្យប្រើ Conda អាចជ្រើស Conda ជំនួស VENV ប៉ុន្តែសម្រាប់និស្សិតថ្មី គួរចាប់ផ្ដើមពី VENV និង Pip ជាមុន។

រូបភាពទី៦៖ Screenshot នៃ Command Palette ដែលបង្ហាញ Python: Create Environment និងជម្រើស Venv។

---

៨.៣ ជម្រើស C៖ បង្កើតតាម Integrated Terminal

បើក៖

Terminal → New Terminal

ពិនិត្យថា Terminal កំពុងស្ថិតក្នុង Project Folder។

Windows

py -m venv .venv

បើពាក្យបញ្ជា python ដំណើរការត្រឹមត្រូវ ក៏អាចប្រើ៖

python -m venv .venv

macOS និង Linux

python3 -m venv .venv

ក្រោយបង្កើតរួច ត្រូវជ្រើស Interpreter ក្នុង .venv តាម Status Bar ឬ Command Palette។

---

៨.៤ ជម្រើស D៖ ជ្រើស Existing Interpreter

បើ .venv មានរួចហើយ ប៉ុន្តែ VS Code មិនទាន់ប្រើវា៖

1. ចុច Python Version នៅ Status Bar។
2. ជ្រើស Interpreter ដែលមានពាក្យ .venv។
3. បើមិនមានក្នុងបញ្ជី ជ្រើស Enter interpreter path…។
4. ចុច Find…។
5. ជ្រើស Python Interpreter ក្នុង .venv។

ផ្លូវ Interpreter ទូទៅ៖

ទីតាំងដាក់រូបភាពទី៧៖ Screenshot ផ្ទាំង Select Interpreter និង Python Version ដែលបង្ហាញ .venv នៅ Status Bar។

---

៨.៥ ជម្រើស E៖ Environment Manager ផ្សេងទៀត

VS Code អាចរកឃើញ Environment ដែលបង្កើតដោយ៖

• VENV
• Conda
• uv
• pyenv
• Poetry
• Pipenv

សម្រាប់និស្សិតថ្មី គួរចាប់ផ្ដើមពី៖

venv + pip

Conda, uv, Poetry និង Pipenv គួរបង្រៀននៅមេរៀនបន្ទាប់ ឬប្រើនៅពេលគម្រោងមានតម្រូវការពិសេស។

---

៩. Activation និង Auto-activation

Activation មានន័យថា ការធ្វើឱ្យ Terminal ប្រើ Python និង Package នៅក្នុង .venv ជំនួស System Python។

ពេល Environment ត្រូវបាន Activate អ្នកអាចឃើញ៖

(.venv)

នៅខាងមុខ Terminal Prompt។

ពាក្យបញ្ជា Activate ដោយដៃ

កំណត់ Auto-activation ក្នុង VS Code

បើក Workspace Settings JSON ហើយបន្ថែម៖

{
  "python-envs.terminal.autoActivationType": "command"
}

តម្លៃដែលអាចប្រើមាន៖

សម្រាប់ថ្នាក់រៀន អាចចាប់ផ្ដើមពី៖

"python-envs.terminal.autoActivationType": "command"

បញ្ហា PowerShell បដិសេធ Activate.ps1

បើឃើញសារដូចជា៖

running scripts is disabled on this system

មិនគួរប្រញាប់បិទការការពារសុវត្ថិភាពទូទាំងម៉ាស៊ីនទេ។ អាចជ្រើសវិធីណាមួយខាងក្រោម៖

• ប្ដូរ VS Code Terminal ទៅ Command Prompt។
• ប្រើ .venv\Scripts\activate.bat។
• ប្រើ Git Bash។
• រត់ Python ក្នុង Environment ដោយផ្លូវពេញ។

ឧទាហរណ៍៖

.venv\Scripts\python.exe src\main.py

វិធីនេះអាចដំណើរការកម្មវិធីដោយមិនចាំបាច់ Activate Environment។

ផ្ទៀងផ្ទាត់ Interpreter

python -c "import sys; print(sys.executable); print(sys.prefix)"
python -m pip --version

ផ្លូវដែលបង្ហាញគួរស្ថិតនៅក្នុង Folder .venv របស់គម្រោង។

---

១០. ដំឡើង PyQt6

ក្រោយជ្រើស ឬ Activate .venv រួច សូមដំឡើង PyQt6៖

python -m pip install --upgrade pip
python -m pip install PyQt6
python -m pip show PyQt6

ការប្រើ៖

python -m pip

ល្អជាងការប្រើ pip ដាច់ៗ ព្រោះវាធានាថា Package ត្រូវបានដំឡើងទៅក្នុង Python Interpreter ដែលកំពុងប្រើពិតប្រាកដ។

បើ python -m pip show PyQt6 បង្ហាញឈ្មោះ ជំនាន់ និងទីតាំង Package មានន័យថា PyQt6 ត្រូវបានដំឡើងរួច។

---

១១. បង្កើតកម្មវិធី PyQt6 ដំបូង

បង្កើត Folder៖

src

ក្នុង Folder src បង្កើតឯកសារ៖

main.py

បញ្ចូលកូដខាងក្រោម៖

import sys

from PyQt6.QtWidgets import QApplication, QLabel


def main():
    app = QApplication(sys.argv)

    label = QLabel("Hello, PyQt6!")
    label.setWindowTitle("My First PyQt6 App")
    label.resize(420, 140)
    label.show()

    sys.exit(app.exec())


if __name__ == "__main__":
    main()

រត់កម្មវិធីពី Project Root៖

python src/main.py

លទ្ធផលរំពឹងទុក គឺបង្អួចមួយមានចំណងជើង៖

My First PyQt6 App

និងបង្ហាញអក្សរ៖

Hello, PyQt6!

បើបង្អួចនេះបើកបាន មានន័យថា៖

• Python ត្រូវបានដំឡើងត្រឹមត្រូវ។
• .venv ត្រូវបានបង្កើតត្រឹមត្រូវ។
• VS Code ប្រើ Interpreter ត្រឹមត្រូវ។
• PyQt6 ត្រូវបានដំឡើងក្នុង Environment ត្រឹមត្រូវ។
• GUI Application អាចដំណើរការបាន។

---

១២. រក្សាទុក Dependencies

ដើម្បីកត់ត្រា Package ដែលគម្រោងកំពុងប្រើ៖

python -m pip freeze > requirements.txt

ក្នុង requirements.txt នឹងមាន Package និងលេខជំនាន់របស់វា។

នៅពេលយកគម្រោងទៅដំឡើងលើម៉ាស៊ីនថ្មី ត្រូវបង្កើត .venv ថ្មី ហើយរត់៖

python -m pip install -r requirements.txt

មិនត្រូវចម្លង Folder .venv ពីម៉ាស៊ីនមួយទៅម៉ាស៊ីនមួយទៀតទេ ព្រោះវាមាន Binary និងផ្លូវឯកសារដែលពាក់ព័ន្ធនឹងប្រព័ន្ធប្រតិបត្តិការដើម។

---

១៣. រចនាសម្ព័ន្ធគម្រោងកម្រិតដំបូង

សម្រាប់លំហាត់ដំបូង អាចរៀបចំដូចខាងក្រោម៖

pyqt6_student_app/
├── .venv/
├── src/
│   └── main.py
├── assets/
├── tests/
├── .gitignore
├── README.md
└── requirements.txt

តួនាទីរបស់ Folder និងឯកសារ៖

• .venv/ រក្សាទុក Environment របស់គម្រោង។
• src/ រក្សាទុក Python Source Code។
• assets/ រក្សាទុករូបភាព Icon Font និង QSS។
• tests/ រក្សាទុកកូដសាកល្បង។
• .gitignore កំណត់ឯកសារដែលមិនត្រូវបញ្ចូលក្នុង Git។
• README.md ពន្យល់អំពីគម្រោង និងរបៀបដំណើរការ។
• requirements.txt កត់ត្រា Package ដែលគម្រោងត្រូវការ។

---

១៤. រចនាសម្ព័ន្ធសម្រាប់គម្រោងឆមាស

នៅពេលគម្រោងមាន GUI, CRUD និង SQLite គួរបែងចែកតួនាទីរបស់កូដឱ្យដាច់ពីគ្នា។

student_management_app/
├── .venv/
├── .vscode/
│   └── settings.json
├── assets/
│   ├── icons/
│   ├── images/
│   └── styles/
│       └── app.qss
├── data/
│   └── app.db
├── src/
│   ├── __init__.py
│   ├── main.py
│   ├── app.py
│   ├── ui/
│   │   ├── __init__.py
│   │   └── main_window.py
│   ├── widgets/
│   ├── models/
│   ├── repositories/
│   ├── services/
│   ├── database/
│   ├── config/
│   └── utils/
├── tests/
│   ├── test_models.py
│   └── test_repositories.py
├── .env.example
├── .gitignore
├── README.md
├── requirements.txt
└── pyproject.toml

តួនាទីរបស់ផ្នែកនីមួយៗ

លំហូរដែលណែនាំសម្រាប់គម្រោង PyQt6 និង SQLite គឺ៖

UI → Service → Repository → SQLite Database

UI មិនគួរសរសេរ SQL ដោយផ្ទាល់។ UI គួរហៅ Service, Service អនុវត្តច្បាប់អាជីវកម្ម ហើយ Repository ទទួលខុសត្រូវលើ CRUD និង Database។

ទីតាំងដាក់រូបភាពទី៨៖ រូប Layered Architecture ដែលមានបួនជាន់៖ “UI”, “Services”, “Repositories” និង “SQLite Database”។

---

១៥. រៀបចំ VS Code Workspace Settings

បង្កើត Folder៖

.vscode

ក្នុង Folder នោះ បង្កើតឯកសារ៖

settings.json

បញ្ចូល៖

{
  "python-envs.workspaceSearchPaths": [
    "./**/.venv"
  ],
  "python-envs.terminal.autoActivationType": "command",
  "python.analysis.extraPaths": [
    "${workspaceFolder}/src"
  ],
  "files.exclude": {
    "**/__pycache__": true,
    "**/*.pyc": true
  }
}

ការកំណត់នេះជួយឱ្យ VS Code៖

• ស្វែងរក .venv ក្នុង Workspace។
• Activate Environment ក្នុង Terminal។
• ស្គាល់ Module ក្នុង Folder src។
• លាក់ __pycache__ និងឯកសារ .pyc ពី Explorer។

មិនគួរសរសេរផ្លូវដែលភ្ជាប់ជាមួយឈ្មោះអ្នកប្រើជាក់លាក់ ដូចជា៖

C:\Users\StudentName\...

ឬ៖

/Users/studentname/...

ក្នុងឯកសារដែលត្រូវចែករំលែកជាក្រុម។

---

១៦. រៀបចំឯកសារ .gitignore

បង្កើតឯកសារ .gitignore នៅ Project Root៖

# Virtual environment
.venv/

# Python cache
__pycache__/
*.py[cod]

# IDE and operating system
.DS_Store
Thumbs.db

# Secrets and local configuration
.env

# Logs and local database backups
*.log
data/*.bak

ឯកសារដែលគួរចែករំលែកមាន៖

• Source Code
• Assets
• README
• .gitignore
• requirements.txt
• pyproject.toml
• Database Schema ឬ Sample Database ដែលគ្មានទិន្នន័យសម្ងាត់

មិនគួរចែករំលែក៖

• .venv
• .env
• Password
• API Key
• Token
• ទិន្នន័យផ្ទាល់ខ្លួន
• Database ផលិតកម្មពិត

---

១៧. ដោះស្រាយបញ្ហាដែលជួបញឹកញាប់

ពាក្យបញ្ជាសម្រាប់ពិនិត្យបញ្ហា

python --version
python -c "import sys; print(sys.executable)"
python -c "import platform; print(platform.platform()); print(platform.machine())"
python -m pip --version
python -m pip show PyQt6
python -c "from PyQt6.QtCore import QT_VERSION_STR; print(QT_VERSION_STR)"

បើ VS Code មិនឃើញ Environment អាចប្រើ Command Palette៖

Python Environments: Refresh All Environment Managers

សម្រាប់ការពិនិត្យកម្រិតខ្ពស់ អាចប្រើ៖

Python Environments: Run Python Environment Tool (PET) in Terminal

រួចជ្រើស៖

Find All Environments

---

១៨. លំហាត់អនុវត្តសម្រាប់និស្សិត
លំហាត់៖ Student Profile GUI

សូមបង្កើតគម្រោងមួយឈ្មោះ៖

student_profile_gui

តម្រូវការលំហាត់៖

1. បើកគម្រោងជា Folder ក្នុង VS Code។
2. បង្កើត .venv តាម Quick Create, Custom Create ឬ Integrated Terminal។
3. ជ្រើស Interpreter ក្នុង .venv។
4. បង្ហាញផ្លូវ Interpreter ដោយប្រើ៖

python -c "import sys; print(sys.executable)"

5. ដំឡើង PyQt6។
6. បង្កើត Window ដែលបង្ហាញ៖
   • ឈ្មោះនិស្សិត
   • អត្តលេខនិស្សិត
   • ជំនាញ
   • ឆ្នាំសិក្សា
   • ប៊ូតុងបិទកម្មវិធី
7. រៀបចំ Folder៖

src/
assets/
tests/

8. បង្កើតឯកសារ៖

README.md
.gitignore
requirements.txt

9. បិទ VS Code ហើយបើកគម្រោងឡើងវិញ។
10. ផ្ទៀងផ្ទាត់ថា Interpreter នៅតែជា .venv។
11. ថត Screenshot បង្ហាញ GUI និងផ្លូវ Interpreter សម្រាប់ដាក់ជូនគ្រូ។

---

១៩. បញ្ជីផ្ទៀងផ្ទាត់មុនបន្តទៅ PyQt6 Widgets

អ្នកសិក្សាគួរផ្ទៀងផ្ទាត់ចំណុចខាងក្រោម៖

• python --version បង្ហាញជំនាន់ Python ដែលថ្នាក់បានកំណត់។
• VS Code Status Bar បង្ហាញ Python ក្នុង .venv។
• Terminal បង្ហាញ (.venv) ឬប្រើ Interpreter ក្នុង .venv។
• python -m pip show PyQt6 រកឃើញ PyQt6។
• python src/main.py អាចបើក GUI បាន។
• requirements.txt មាន PyQt6។
• .gitignore មាន .venv/។
• Source Code ត្រូវបានដាក់ក្នុង src/។
• Assets ត្រូវបានរក្សាទុកដាច់ពី Python Code។
• មិនមាន Password ឬ API Key នៅក្នុង Source Code។
• សម្រាប់គម្រោងធំ កូដទាំងអស់មិនត្រូវប្រមូលនៅក្នុង main.py តែមួយ។

---

សេចក្ដីសន្និដ្ឋាន

ការរៀបចំបរិស្ថានអភិវឌ្ឍឱ្យបានត្រឹមត្រូវ គឺជាគ្រឹះសំខាន់របស់ការសរសេរកម្មវិធី PyQt6។ នៅពេល Python Interpreter, VENV, VS Code និង Package ត្រូវគ្នា អ្នកសិក្សាអាចផ្ដោតលើការរចនា GUI, Layout, Widget, Signal/Slot, CRUD និង SQLite ដោយមិនត្រូវចំណាយពេលដោះស្រាយបញ្ហា «ដំឡើងរួច ប៉ុន្តែរកមិនឃើញ» ម្តងហើយម្តងទៀត។

សម្រាប់គម្រោងដំបូង អ្នកសិក្សាគួរប្រើ venv + pip ប្រើឈ្មោះ Environment ជា .venv និងរៀបចំ Source Code, Assets, Database, Service និង Repository ដាច់ពីគ្នា។ ស្តង់ដារនេះនឹងជួយឱ្យគម្រោងងាយស្រួលអាន សាកល្បង ថែទាំ ចែករំលែក និងអភិវឌ្ឍបន្តទៅជាកម្មវិធីគ្រប់គ្រងទិន្នន័យពេញលេញ។

ប្រភពឯកសារផ្លូវការ

• Visual Studio Code—Python Environments
• Visual Studio Code—Getting Started with Python
• Python Documentation—venv
• VS Code Setup—Windows
• VS Code Setup—macOS
• VS Code Setup—Linux
• Python Package Index—PyQt6

កំណត់សម្គាល់៖ ផ្ទាំង និងទីតាំងប៊ូតុងក្នុង VS Code អាចផ្លាស់ប្ដូរបន្តិចតាមជំនាន់កម្មវិធី។ ប្រសិនបើរកប៊ូតុងមិនឃើញ សូមប្រើ Command Palette ហើយស្វែងរកតាមឈ្មោះ Command ដែលបានណែនាំក្នុងអត្ថបទ។