Phase 00: Setup & Tooling

تنظیمات ویرایشگر

. مدیر شما همپلوتی شماست . یک بار آن را تنظیم کنید تا از راه شما دور بماند و شروع به کشیدن وزن خود کند

Type: Build

Languages: --

Prerequisites: Phase 0, Lesson 01

Time: ~20 minutes

اهداف یادگیری

نصب کد VS با افزونه های ضروری برای پایتون، Jupyter، linting و SSH از راه دور
تنظیم قالب-در- ذخیره، بررسی نوع و اسکرول ورودی نوت بوک برای جریان کار هوش مصنوعی
تنظیم Remote SSH برای ویرایش و اشکال زدایی کد در دستگاه های GPU دور افتاده مانند آنها محلی
ارزیابی گزینه های ویرایشگر (Cursor، Windsurf، Neovim) و معامله های آنها برای کار هوش مصنوعی

مشکل

شما هزاران ساعت را در داخل ویرایشگر خود می گذرانید که پایتون را می نویسید، نوت بوکها را اجرا می کنید، حلقه های آموزشی را خراب می کنید و SSH را در جعبه های GPU قرار می دهید. یک ویرایشگر اشتباه هر جلسه را به اصطکاک تبدیل می کند: هیچ تعدیل خودکار، هیچ راهنمایی تایپ، هیچ خط خط خط، فرمت دستی و یک جریان کار محرکه.

تنظیم درست 20 دقیقه طول میکشه و ازش فرار کردن 20 دقیقه رو در روز میخوره

مفهوم

یک ویرایشگر مهندسی هوش مصنوعی به پنج چیز نیاز دارد:

graph TD
    L5["5. Remote Development<br/>SSH into GPU boxes, cloud VMs"] --> L4
    L4["4. Terminal Integration<br/>Run scripts, debug, monitor GPU"] --> L3
    L3["3. AI-Specific Settings<br/>Auto-format, type checking, rulers"] --> L2
    L2["2. Extensions<br/>Python, Jupyter, Pylance, GitLens"] --> L1
    L1["1. Base Editor<br/>VS Code — free, extensible, universal"]

آن را بسازید

مرحله اول: کد VS را نصب کنید

VS Code ویرایشگر توصیه شده است. این رایگان است، در هر سیستم عامل اجرا می شود، پشتیبانی از لپ تاپ های Jupyter درجه اول دارد و اکوسیستم تمدید همه چیز را برای کار هوش مصنوعی نیاز دارید.

از code.visualstudio.com. .

از ترمینال چک کن:

bashcode --version

اگهcodeدر macOS پیدا نمی شود، کد VS را باز کنید، فشار دهید Cmd+Shift+P، "شال فرمان" را تایپ کنید و "نظم کد را در PATH نصب کنید" را انتخاب کنید.

مرحله دوم: افزونه های ضروری را نصب کنید

ترمینال یکپارچه را در کد VS باز کنید () Ctrl+``` در هر پلتفرم) و نصب افزونهایی که برای کار هوش مصنوعی مهم هستند:

bashcode --install-extension ms-python.python
code --install-extension ms-python.vscode-pylance
code --install-extension ms-toolsai.jupyter
code --install-extension eamodio.gitlens
code --install-extension ms-vscode-remote.remote-ssh
code --install-extension ms-python.debugpy
code --install-extension ms-python.black-formatter
code --install-extension charliermarsh.ruff

هرکدوم از اونا چه کار ميکنن:

Extension	Why
Python	Language support, virtual env detection, run/debug
Pylance	Fast type checking, autocomplete, import resolution
Jupyter	Run notebooks inside VS Code, variable explorer
GitLens	See who changed what, inline git blame
Remote SSH	Open a folder on a remote GPU box as if it were local
Debugpy	Step-through debugging for Python
Black Formatter	Auto-format on save, consistent style
Ruff	Fast linting, catches common mistakes

پروندهcode/.vscode/extensions.jsonدر این درس، لیست کامل توصیه ها وجود دارد. وقتی پوشه پروژه را باز می کنید، کد VS شما را به نصب آنها می خواهد.

مرحله سوم: تنظیم تنظیمات

تنظیمات رو از کپی کنcode/.vscode/settings.jsonدر این درس، یا آنها را به صورت دستی از طریق Settings > Open Settings (JSON). .

تنظیمات کلیدی برای کار هوش مصنوعی:

jsonc{
    "python.analysis.typeCheckingMode": "basic",
    "editor.formatOnSave": true,
    "editor.rulers": [88, 120],
    "notebook.output.scrolling": true,
    "files.autoSave": "afterDelay"
}

چرا این ها مهم هستند:

Type checking on basic: قبل از اجرا کردن انواع اشتباه استدلال را ضبط می کند. زمان دیبگینگ در عدم مطابقت شکل تنسور و پارامترهای API اشتباه را ذخیره می کند.
Format on saveهرگز به فرمت کردن فکر نکنم. سیاهش کارش رو انجام میده.
Rulers at 88 and 120: سیاه بسته در 88 نشانگر 120 نشان می دهد که زمانی که سند ها و نظرات بیش از حد طولانی می شوند.
Notebook output scrolling: حلقه های آموزش هزاران خط چاپ می کنند. بدون اسکرول، پنل خروجی منفجر می شود.
Auto-saveشما ذخیره کردن را فراموش خواهید کرد. اسکریپت آموزش شما کد قدیمی را اجرا خواهد کرد. ذخیره سازی خودکار مانع از این می شود.

مرحله چهارم: ادغام ترمینال

ترمینال یکپارچه VS Code جایی است که شما اسکریپت های آموزشی را اجرا می کنید، GPU ها را نظارت می کنید و محیط ها را مدیریت می کنید.

درست تنظیمش کن

jsonc{
    "terminal.integrated.defaultProfile.osx": "zsh",
    "terminal.integrated.defaultProfile.linux": "bash",
    "terminal.integrated.fontSize": 13,
    "terminal.integrated.scrollback": 10000
}

راه کوتاه های مفید:

Action	macOS	Linux/Windows
Toggle terminal	` `Ctrl+` ` `\|` `Ctrl+` ``
New terminal	` `Ctrl+Shift+` ` `\|` `Ctrl+Shift+` ``
Split terminal	`Cmd+\`	`Ctrl+Shift+5`

ترمینل های تقسیم شده مفید هستند: یکی برای اجرای اسکریپت شما، یکی برای نظارت بر GPU با nvidia-smi -l 1یاwatch -n 1 nvidia-smi. .

مرحله 5: توسعه از راه دور (SSH به جعبه های GPU)

این مهمترین افزونه برای کار هوش مصنوعی است. شما در ماشین های دور افتاده (VM های ابر، سرورهای آزمایشگاه، Lambda، Vast.ai) آموزش اجرا خواهید کرد. SSH از راه دور به شما امکان می دهد سیستم فایل های دور افتاده را باز کنید، فایل ها را ویرایش کنید، ترمینال ها را اجرا کنید و هر چیزی را درست کنید.

تنظیم:

افزونه SSH را از راه دور نصب کنید (در مرحله 2 انجام شده).
مطبوعاتCtrl+Shift+P(یا Cmd+Shift+P), نوع "Remote-SSH: Connect to Host" را تایپ کنید.
وارد شوuser@your-gpu-box-ip. .
VS Code به طور خودکار بخش سرور خود را روی دستگاه ریموتی نصب می کند.

برای دسترسی بدون رمز عبور، کلید های SSH را تنظیم کنید:

bashssh-keygen -t ed25519 -C "your-email@example.com"
ssh-copy-id user@your-gpu-box-ip

میزبان را به اضافه کنید~/.ssh/configبرای راحتی:

Host gpu-box
    HostName 203.0.113.50
    User ubuntu
    IdentityFile ~/.ssh/id_ed25519
    ForwardAgent yes

حالاRemote-SSH: Connect to Host > gpu-boxبه طور فوری متصل می شود.

گزینه های دیگر

کلر

cursor.comاین یک فورک کد VS با تولید کد هوش مصنوعی ساخته شده است. از همان اکوسیستم تمدید و قالب تنظیمات استفاده می کند. اگر از Cursor استفاده کنید، همه چیز در این درس هنوز هم اعمال می شود. همان ها را وارد کنید settings.jsonوextensions.json. .

سرفنگ باد

windsurf.comهمان داستان: همان افزونه ها، همان قالب تنظیمات، همان پشتیبانی از SSH از راه دور.

Vim/Neovim

اگر شما قبلا از Vim یا Neovim استفاده می کنید و در آن بهره مند هستید، در آنجا بمانید. حداقل تنظیم برای کار AI Python:

pyrightیاpylspبرای بررسی نوع (بر اساس ماشین آلات یا نصب دستی)
nvim-lspconfigبرای ادغام سرور زبان
jupyter-vimیاmolten-nvimبرای اجرای مانند یک دفترچه یادداشت
telescope.nvimبرای جستجوی فایل/نمونه
none-ls.nvimبا رنگ سیاه و رنگی برای فرمت کردن/پوشاندن

اگر شما هنوز از Vim استفاده نمی کنید، همین الان شروع نکنید. منحنی یادگیری با یادگیری مهندسی هوش مصنوعی رقابت خواهد کرد. از VS Code استفاده کنید.

ازش استفاده کن

با اين ترتيب، سير کار روزانه شما به اين شکل مياد:

پوشه پروژه را در کد VS باز کنید (یا از طریق SSH راه دور به یک جعبه GPU متصل شوید).
پایتون را با خودکار تکمیل، راهنمایی تایپ و خط خط در ویرایشگر بنویسید.
دفترچه های نوتیف Jupyter را با افزونه Jupyter اجرا کنید.
از ترمینال یکپارچه برای اسکریپت های آموزش استفاده کنیدuv pip install، و نظارت GPU
قبل از تعهد تغییرات را با GitLens بررسی کنید.

تمرینات

نصب کد VS و تمام افزونه های ذکر شده در مرحله 2
کپی ازsettings.jsonاز اين درس به صورت تعيين کد VS
یک فایل پایتون را باز کنید و تایید کنید که Pylance در save، راهنمایی های تایپ و قالب های سیاه را نشان می دهد
اگر به یک دستگاه از راه دور دسترسی دارید، Remote SSH را تنظیم کنید و یک پوشه را روی آن باز کنید

اصطلاحات کلیدی

Term	What people say	What it actually means
LSP	"Autocomplete engine"	Language Server Protocol: a standard for editors to get type info, completions, and diagnostics from a language-specific server
Pylance	"The Python plugin"	Microsoft's Python language server using Pyright for type checking and IntelliSense
Remote SSH	"Working on the server"	VS Code extension that runs a lightweight server on a remote machine and streams the UI to your local editor
Format on save	"Auto-prettier"	The editor runs a formatter (Black, Ruff) every time you save, so code style is always consistent

This free lesson is part of the AI Engineering from Scratch curriculum. Read the full explanation, run the lesson code, and verify the result in the interactive reader or from the repository source.

Browse the complete course catalog or open this lesson on GitHub.