پاورشل برای برنامه‌نویسان

درسنامه: ارتباط با VS Code و Terminal

این درسنامه درباره‌ی نحوه‌ی استفاده از PowerShell در محیط Visual Studio Code (VS Code) و نحوه‌ی ارتباط آن با Terminal است. هدف، یادگیری نحوه‌ی تنظیم، اجرا و یکپارچه‌سازی PowerShell با محیط توسعه است تا بتوان اسکریپت‌ها و فرمان‌ها را سریع‌تر و حرفه‌ای‌تر مدیریت کرد.

۱. نقش VS Code در کار با PowerShell

وی اس کد یک محیط توسعه‌ی سبک و منعطف است که با نصب افزونه‌ها می‌تواند برای هر زبان برنامه‌نویسی از جمله PowerShell آماده شود. در واقع VS Code فقط یک ادیتور نیست، بلکه می‌تواند نقش یک IDE کامل را برای PowerShell ایفا کند:

• اجرای مستقیم دستورات PowerShell
• مشاهده‌ی خروجی و خطاها در Terminal
• Debug کردن اسکریپت‌ها
• رنگ‌بندی و تکمیل خودکار (IntelliSense)
• مدیریت ماژول‌ها و فایل‌های .ps1

۲. نصب افزونه‌ی PowerShell در VS Code

برای شروع، باید افزونه‌ی رسمی PowerShell را نصب کرد:

1. وی اس کد را باز کن.
2. از نوار سمت چپ روی آیکن Extensions (یا کلید میانبر Ctrl + Shift + X) کلیک کن.
3. در بخش جستجو عبارت PowerShell را بنویس.
4. افزونه‌ی رسمی Microsoft PowerShell را انتخاب و نصب کن.

بعد از نصب، VS Code به‌طور خودکار محیط PowerShell را تشخیص می‌دهد و در پایین پنجره (status bar) نسخه‌ی PowerShell فعال را نمایش می‌دهد.

۳. تنظیم ترمینال داخلی VS Code برای PowerShell

وی اس کد به‌صورت پیش‌فرض از PowerShell به عنوان ترمینال داخلی ویندوز استفاده می‌کند. اما اگر قبلاً آن را تغییر داده‌ای، می‌توان دوباره تنظیمش کرد:

1. از منو به File → Preferences → Settings برو.
2. در قسمت جستجو بنویس: default profile terminal
3. گزینه‌ی Terminal › Integrated: Default Profile: Windows را پیدا کن.
4. مقدار آن را روی PowerShell تنظیم کن.

اکنون هر زمان که ترمینال داخلی (`Ctrl + ``) را باز کنی، PowerShell اجرا می‌شود.

۴. اجرای اسکریپت PowerShell در VS Code

بعد از نوشتن اسکریپت مثلاً در فایل script.ps1، چند روش برای اجرا وجود دارد:

• روش ۱: راست‌کلیک در ادیتور و انتخاب گزینه‌ی
• “Run PowerShell”
• روش ۲: فشردن کلید F5 برای اجرا و Debug
• روش ۳: باز کردن ترمینال داخلی و تایپ دستور:

.\script.ps1

• روش ۴: انتخاب بخشی از کد و فشردن Ctrl + F8 برای اجرای همان بخش انتخاب‌شده

خروجی اسکریپت در همان ترمینال VS Code نمایش داده می‌شود.

۵. تنظیم Execution Policy برای اجرای اسکریپت‌ها

اگر برای اولین‌بار اسکریپت اجرا می‌کنی، ممکن است خطای Execution Policy بگیری. برای رفع آن، در ترمینال VS Code بنویس:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

سپس گزینه‌ی [A] Yes to All را انتخاب کن تا اجرای اسکریپت‌ها مجاز شود.

۶. دیباگ کردن اسکریپت‌ها در VS Code

افزونه‌ی PowerShell قابلیت Debug دارد، یعنی می‌توانی به‌صورت گام‌به‌گام اسکریپت را اجرا و بررسی کنی:

1. در کنار خطی از کد کلیک کن تا BreakPoint قرار گیرد.
2. کلید F5 را بزن تا Debug شروع شود.
3. با کلیدهای F10 یا F11 مراحل اجرا را دنبال کن.
4. در قسمت Watch می‌توانی مقدار متغیرها را در حین اجرا ببینی.

این ویژگی مخصوصاً برای پروژه‌های بزرگ یا اسکریپت‌های پیچیده بسیار مفید است.

۷. ارتباط VS Code با محیط ترمینال سیستم

ترمینال داخلی VS Code دقیقاً همان PowerShell واقعی سیستم است. یعنی هر دستوری که در PowerShell بیرون از VS Code می‌نویسی، اینجا هم همان نتیجه را دارد. حتی می‌توان چند ترمینال مختلف داشت (مثلاً CMD، Git Bash و PowerShell در کنار هم).

می‌توان ترمینال جدید باز کرد با کلید میانبر:

Ctrl + Shift + `

و از منوی کشویی بالای ترمینال، بین محیط‌ها جابه‌جا شد.

۸. ذخیره و اجرای خودکار (Task Runner)

وی اس کد قابلیتی به نام Tasks دارد که می‌تواند PowerShell را به‌صورت خودکار اجرا کند. مثلاً هر بار که فایل ذخیره می‌شود، یک اسکریپت اجرا شود.

برای این کار:

1. از منوی Terminal → Configure Tasks را انتخاب کن.
2. گزینه‌ی Create tasks.json file را بزن.
3. در فایل بازشده، چنین تنظیمی بنویس:

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Run PowerShell Script",
      "type": "shell",
      "command": "powershell.exe",
      "args": ["-ExecutionPolicy", "Bypass", "-File", "build.ps1"]
    }
  ]
}

اکنون با Ctrl + Shift + B، اسکریپت موردنظر اجرا می‌شود.

۹. بهینه‌سازی تجربه کار با PowerShell در VS Code

برای تجربه‌ی بهتر کار با PowerShell در VS Code، چند نکته‌ی مفید:

• فعال کردن Code Formatting خودکار با کلید Shift + Alt + F
• روشن کردن IntelliSense برای پیشنهاد خودکار Cmdletها
• استفاده از Outline View برای مشاهده‌ی توابع و ساختار اسکریپت
• نصب افزونه‌ی PSScriptAnalyzer برای بررسی خطاها و بهینه‌سازی کد

۱۰. جمع‌بندی

• وی اس کد بهترین محیط برای کار و توسعه‌ی اسکریپت‌های PowerShell است.
• با نصب افزونه‌ی PowerShell، می‌توان کدنویسی، اجرای دستورات و دیباگ را هم‌زمان در یک محیط انجام داد.
• ترمینال داخلی VS Code همان PowerShell واقعی سیستم است و تمام دستورات را پشتیبانی می‌کند.
• امکاناتی مثل Task Runner، Debugging و IntelliSense باعث می‌شوند کار با PowerShell سریع‌تر و حرفه‌ای‌تر شود.

با تسلط بر این درس، عملاً می‌توانی PowerShell را به‌عنوان بخشی از فرآیند توسعه‌ی روزمره‌ات در VS Code به کار بگیری و از آن برای خودکارسازی کارها و مدیریت پروژه‌ها استفاده کنی.