پرش به مطلب اصلی

توسعه اسکریپت‌ها با VSCode

ScriptCat یک افزونه VSCode ارائه می‌دهد که به شما امکان می‌دهد اسکریپت‌های کاربری را در VSCode بنویسید. پس از ذخیره، تغییرات به طور خودکار به ScriptCat در مرورگر همگام‌سازی می‌شوند — بدون نیاز به کپی‌پیست دستی، که به طور قابل توجهی کارایی توسعه را افزایش می‌دهد.

پیش‌نیازها​

باید دو ابزار زیر را نصب کنید:

  1. افزونه ScriptCat را در مرورگر خود نصب کنید — اگر هنوز نصب نکرده‌اید، برای نصب از راهنمای شروع سریع پیروی کنید
  2. افزونه ScriptCat را در VSCode نصب کنید — «scriptcat-vscode» را در بازار افزونه‌های VSCode جستجو کنید، یا آن را از مخزن گیت‌هاب دانلود کنید

برقراری اتصال​

پس از نصب، باید افزونه ScriptCat در مرورگر خود را با VSCode متصل کنید:

  1. روی آیکون ScriptCat در مرورگر خود کلیک کنید تا پنل مدیریت باز شود
  2. به ابزارها > ابزارهای توسعه‌دهنده بروید
  3. اتصال خودکار به سرویس VSCode را پیدا کنید، آن را فعال کنید و روی اتصال کلیک کنید

پس از اتصال، یک کانال بلادرنگ بین VSCode و ScriptCat برقرار می‌شود.

همگام‌سازی اسکریپت‌ها​

پس از برقراری اتصال، می‌توانید یکی از دو روش برای همگام‌سازی اسکریپت‌ها انتخاب کنید:

گزینه ۱: حالت تشخیص خودکار (توصیه‌شده)​

  1. در VSCode، Ctrl + Shift + P (Cmd + Shift + P در مک) را فشار دهید تا پالت فرمان باز شود
  2. scriptcat.autoTarget را تایپ و انتخاب کنید
  3. از این پس، هر بار که یک فایل .user.js را باز یا ذخیره می‌کنید، به طور خودکار به ScriptCat همگام‌سازی می‌شود

گزینه ۲: حالت اسکریپت مشخص​

  1. در VSCode، Ctrl + Shift + P (Cmd + Shift + P در مک) را فشار دهید تا پالت فرمان باز شود
  2. scriptcat.target را تایپ و انتخاب کنید
  3. مسیر فایل اسکریپت مورد نظر برای همگام‌سازی را مشخص کنید

جریان توسعه​

پس از راه‌اندازی، جریان توسعه بسیار ساده است:

  1. اسکریپت .user.js خود را در VSCode بنویسید یا ویرایش کنید
  2. Ctrl + S را فشار دهید تا فایل ذخیره شود
  3. اسکریپت به طور خودکار به ScriptCat در مرورگر همگام‌سازی می‌شود
  4. به مرورگر بروید و صفحه را تازه‌سازی کنید تا نتیجه را ببینید

کل فرآیند به هیچ مرحله دستی نیاز ندارد — ذخیره بلافاصله اعمال می‌شود.

سوالات متداول​

اگر اتصال برقرار نشد چه کنم؟​

  • مطمئن شوید افزونه ScriptCat در مرورگر شما در حال اجرا است
  • مطمئن شوید افزونه ScriptCat در VSCode نصب و فعال است
  • وضعیت اتصال را در صفحه «ابزارهای توسعه‌دهنده» در پنل مدیریت ScriptCat بررسی کنید

اسکریپت پس از ذخیره به‌روزرسانی نمی‌شود؟​

  • مطمئن شوید نام فایل به .user.js ختم می‌شود
  • مطمئن شوید فرمان scriptcat.autoTarget یا scriptcat.target را اجرا کرده‌اید
  • پنل خروجی VSCode را برای هر پیام خطا بررسی کنید

آیا پس از راه‌اندازی مجدد VSCode باید دوباره متصل شوم؟​

اگر «اتصال خودکار به سرویس VSCode» فعال باشد، VSCode پس از راه‌اندازی مجدد به طور خودکار دوباره متصل می‌شود — بدون نیاز به هیچ مرحله دستی.