برنامه خود را در Firebase Studio اشکال زدایی کنید، برنامه خود را در Firebase Studio اشکال زدایی کنید، برنامه خود را در Firebase Studio اشکال زدایی کنید، برنامه خود را در Firebase Studio اشکال زدایی کنید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
Firebase Studio چند راه مختلف برای اشکال زدایی برنامه شما، مستقیماً از فضای کاری شما ارائه می دهد. برای برنامه های وب و Flutter، یک کنسول وب و Lighthouse مستقیماً در فضای کاری ادغام می شوند. برنامه‌های Flutter پیش‌نمایش‌های اندروید و وب را برای بررسی و آزمایش برنامه شما در حین کدنویسی ارائه می‌دهند.
اشکال‌زدایی غنی‌تر و مبتنی بر نقطه شکست نیز برای اکثر زبان‌های رایج، از طریق کنسول Debug داخلی، و با پسوندهای Debugger از OpenVSX قابل توسعه است. برای اشکال‌زدایی کد وب ظاهری خود (مانند جاوا اسکریپت) مبتنی بر نقطه انفصال، می‌توانید از ابزارهای توسعه‌دهنده داخلی مرورگر خود مانند ابزار توسعه Chrome استفاده کنید.
پیش نمایش برنامه شما
Firebase Studio شامل پیش‌نمایش‌های برنامه‌های درون فضای کاری برای برنامه‌های وب (Chrome) و برنامه‌های Flutter (اندروید، کروم) است. پیش‌نمایش‌های Android و Chrome از بارگذاری مجدد و بازخوانی داغ پشتیبانی می‌کنند و قابلیت‌های کامل شبیه‌ساز را ارائه می‌دهند.
برای کسب اطلاعات بیشتر درباره پیش‌نمایش‌های Firebase Studio ، به پیش‌نمایش برنامه خود مراجعه کنید.
از کنسول وب یکپارچه برای پیش نمایش وب استفاده کنید
کنسول وب یکپارچه به شما کمک می کند مشکلات برنامه خود را مستقیماً از پیش نمایش وب تشخیص دهید. با گسترش نوار در پایین، می توانید به کنسول وب در پانل پیش نمایش وب Firebase Studio دسترسی پیدا کنید.
توجه داشته باشید که این ویژگی آزمایشی است و به طور پیش فرض فعال نیست. برای روشن کردن آن، این مراحل را دنبال کنید و پس از امتحان بازخورد خود را به اشتراک بگذارید :
کنسول وب را به فضای کاری Firebase Studio خود اضافه کنید:
- تنظیمات را با کلیک کردن روی settings یا فشار دادن
Ctrl + , (در Windows/Linux/ChromeOS) یا Cmd + , (در MacOS) باز کنید. - تنظیمات Firebase Studio : Web Dev Tools را پیدا کرده و آن را فعال کنید. اگر فایل
settings.json خود را مستقیماً ویرایش می‌کنید، می‌توانید "IDX.webDevTools": true . - برای بارگیری مجدد فضای کاری Firebase Studio خود، پنجره مرورگر خود را بازخوانی کنید.
باز کردن پیش‌نمایش وب در Firebase Studio : پالت فرمان ( Cmd+Shift+P در Mac یا Ctrl+Shift+P در ChromeOS، Windows یا Linux) را باز کنید و Firebase Studio را انتخاب کنید: نمایش پیش‌نمایش وب .
پانل کنسول وب به طور پیش فرض در پانل پیش نمایش وب به حداقل می رسد. روی نوار کلیک کنید یا آن را به سمت بالا بکشید تا بزرگ شود.
پانل کنسول وب در پیش‌نمایش وب Firebase Studio مشابه کنسول‌های دیگر، مانند کنسول موجود در Chrome DevTools ، کار می‌کند:
- هنگام استفاده از برنامه خود، خطاهای جاوا اسکریپت و عبارات
console.log در آنجا ظاهر می شوند.- برای خطاها و هشدارها، می‌توانید با انتخاب دکمه Understand this error در سمت راست پیام خطا، از Gemini کمک بگیرید.
- شما می توانید جاوا اسکریپت دلخواه را در زمینه پیش نمایش وب خود با استفاده از نوار اعلان در پایین ارزیابی کنید.
Lighthouse را برای پیش نمایش وب اجرا کنید
Lighthouse برنامه شما را بر اساس دسته بندی های ممیزی خاصی که انتخاب می کنید ممیزی می کند و گزارشی را با یافته ها و پیشنهادها برمی گرداند. می‌توانید گزارش‌های Lighthouse را مستقیماً از پیش‌نمایش وب در Firebase Studio اجرا کنید.
باز کردن پیش‌نمایش وب در Firebase Studio : پالت فرمان را باز کنید ( Cmd+Shift+P در Mac یا Ctrl+Shift+P در ChromeOS، Windows یا Linux) Firebase Studio را انتخاب کنید: نمایش پیش‌نمایش وب .
را کلیک کنید 
نماد Lighthouse را از نوار ابزار پیش نمایش وب اجرا کنید .
در پنل Lighthouse، دسته بندی های ممیزی را که می خواهید انتخاب کنید. شما می توانید از میان گزارش های حسابرسی عملکرد ، دسترسی ، مطابقت با بهترین شیوه ها ، سئو و عملکرد برنامه وب پیشرو انتخاب کنید. برای تولید گزارش ها روی آنالیز صفحه کلیک کنید.
تولید گزارش ها ممکن است چند دقیقه طول بکشد.
پس از اینکه گزارش ها در پانل Lighthouse ظاهر شدند، می توانید یافته های هر دسته حسابرسی را بررسی کنید، یا با کلیک روی امتیاز و نام دسته، بین دسته های حسابرسی جابجا شوید.
از کنسول Debug استفاده کنید
Firebase Studio شامل Debug Console داخلی از Code OSS است. از این کنسول برای اشکال‌زدایی برنامه خود با اشکال‌زدایی‌های خارج از جعبه برای اکثر زبان‌های برنامه‌نویسی رایج استفاده کنید یا یک برنامه افزودنی اشکال‌زدایی از OpenVSX اضافه کنید.
برای سفارشی کردن تجربه اشکال زدایی، می توانید یک فایل .vscode/launch.json را نیز به فضای کاری خود اضافه کنید و پیکربندی های راه اندازی سفارشی را مشخص کنید. در مورد استفاده از فایل های پیکربندی راه اندازی برای سفارشی کردن اشکال زدایی در پیکربندی اشکال زدایی کد ویژوال استودیو بیشتر بیاموزید.
اشکال زدایی با Gemini
می توانید از Gemini در Firebase استفاده کنید تا به شما کمک کند کد خود را با چت در فضای کاری Code یا App Prototyping agent اشکال زدایی کنید.
در حالی که Gemini می تواند برای شما کد بنویسد، ممکن است گاهی اوقات خطا نیز ایجاد کند. وقتی خطایی را تشخیص داد، سعی می کند آن را برطرف کند. اگر متوجه شدید که با توجه به پیام خطا نمی تواند مشکل را حل کند، می توانید برخی از تکنیک های زیر را امتحان کنید:
مشکل را شرح دهید: در رابط چت، مشکلی را که با آن روبرو می شوید تا حد امکان واضح و مختصر شرح دهید. در حالی که Gemini ممکن است به زمینه هایی مانند پیام های خطا و گزارش ها دسترسی داشته باشد، ممکن است متن کامل را درک نکند. توصیف رفتار همراه با پیام خطا می تواند به Gemini کمک کند تا خطاها را سریعتر برطرف کند.
سوالات خاص بپرسید: از پرسیدن سوالات مستقیم Gemini در مورد کد خود نترسید. به عنوان مثال، "چه چیزی می تواند باعث استثنای اشاره گر تهی در این تابع شود؟" یا "چگونه می توانم از این شرایط مسابقه جلوگیری کنم؟"
مشکلات پیچیده را تجزیه کنید: اگر با یک مسئله پیچیده سر و کار دارید، آن را به بخش های کوچکتر و قابل مدیریت تقسیم کنید. از Gemini بخواهید که به شما کمک کند تا هر قسمت را به طور جداگانه اشکال زدایی کنید و گام به گام به مشکلات فکر کنید.
از حصارهای کد استفاده کنید: هنگام به اشتراک گذاری قطعات کد، از حصارهای کد استفاده کنید تا مطمئن شوید که کد به درستی قالب بندی شده است. این امر خواندن و درک کد شما را برای Gemini آسان تر می کند.
تکرار و اصلاح: جمینی ممکن است همیشه در اولین تلاش راه حل عالی ارائه نکند. پاسخ‌ها را مرور کنید، سؤالات روشن‌کننده بپرسید و در صورت نیاز اطلاعات بیشتری ارائه دهید.
از حلقه های درخواستی خودداری کنید: اگر Gemini در یک حلقه گیر کرد یا قادر به پاسخگویی به سؤال شما نیست، سعی کنید درخواست خود را دوباره بیان کنید یا زمینه اضافی را ارائه دهید. گاهی اوقات، فقط بازنویسی سؤال خود می تواند به جوزا کمک کند تا بفهمد چه می پرسید.
اگر بازنویسی درخواست شما حلقه را حل نمی کند، تکنیک های زیر را امتحان کنید:
شروع یک چت جدید: اگر از Gemini در چت Firebase در فضای کاری Code خود استفاده می کنید، یک جلسه گپ جدید را برای بازنشانی زمینه Gemini شروع کنید. این می تواند به رهایی از هرگونه تصور اشتباه یا فرضی که جوزا ممکن است در گفتگوی قبلی داشته باشد کمک کند.
مثال‌های متقابل ارائه کنید: اگر جمینی مفروضات نادرستی می‌کند، مثال‌های متقابل ارائه کنید تا به او در درک رفتار صحیح کمک کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["Firebase Studio offers a few different ways to debug your app, directly\nfrom your workspace. For web and Flutter apps, a web console and\n[Lighthouse](https://developer.chrome.com/docs/lighthouse/overview)\nare directly integrated into the workspace. Flutter apps offer Android and web\npreviews to spot-check and test your app while you code.\n\nRicher, breakpoint-based debugging is also available for most common languages,\nthrough the built-in Debug Console, and extensible with [Debugger extensions\nfrom OpenVSX](https://open-vsx.org/?category=Debuggers). For\nbreakpoint-based debugging of your frontend web code (like JavaScript), you can\ncontinue using your browser's built-in developer tools, like\n[Chrome's DevTools](https://developer.chrome.com/docs/devtools).\n\nPreview your app\n\nFirebase Studio includes\n[in-workspace app previews](/docs/studio/preview-apps) for web apps (Chrome)\nand Flutter apps (Android, Chrome). The\nAndroid and Chrome previews support hot reload and hot refresh, and offer full\nemulator capabilities.\n\nTo learn more about Firebase Studio previews, see\n[Preview your app](/docs/studio/preview-apps).\n\nUse the integrated web console for web previews\n\nThe integrated web console helps you diagnose issues in your app directly\nfrom the web preview. You can access the web console in the\nFirebase Studio web preview panel by expanding the bar at the bottom.\n\nNote that this feature is experimental and isn't enabled by default. To\nturn it on, follow these steps, and [share your\nfeedback](/support/troubleshooter/studio) after\nyou've tried it out:\n\n1. Add the web console to your Firebase Studio workspace:\n\n 1. Open **Settings** by clicking settings or pressing `Ctrl + ,` (on Windows/Linux/ChromeOS) or `Cmd + ,` (on MacOS).\n 2. Find the **Firebase Studio: Web Dev Tools** setting and enable it. If you're editing your `settings.json` file directly, you can add `\"IDX.webDevTools\": true`.\n 3. Refresh your browser window to reload your Firebase Studio workspace.\n2. Open the web preview in Firebase Studio: Open the command palette\n (`Cmd+Shift+P` on Mac or `Ctrl+Shift+P` on ChromeOS, Windows, or Linux)\n and select **Firebase Studio: Show Web Preview**.\n\n3. The web console panel is minimized within the web preview panel by default.\n Click the bar or drag it up to expand it.\n\nThe web console panel in the Firebase Studio web preview works\nsimilarly to other consoles, such as the one available in\n[Chrome DevTools](https://developer.chrome.com/docs/devtools):\n\n- JavaScript errors and `console.log` statements will appear there as you use your app.\n - For errors and warnings, you also have the option to get assistance from Gemini by selecting the **Understand this error** button at the right of the error message.\n- You can evaluate arbitrary JavaScript in the context of your web preview by using the prompt bar at the bottom.\n\nRun Lighthouse for web previews\n\n[Lighthouse](https://developer.chrome.com/docs/lighthouse/overview)\naudits your app based on the specific audit categories you select, and returns\na report with findings and suggestions. You can run Lighthouse reports directly\nfrom the web preview in Firebase Studio.\n\n1. Open the web preview in Firebase Studio: Open the command palette\n (`Cmd+Shift+P` on Mac or `Ctrl+Shift+P` on ChromeOS, Windows, or\n Linux) select **Firebase Studio: Show Web Preview**.\n\n2. Click the\n **Run Lighthouse** icon from the web preview toolbar.\n\n3. In\n the Lighthouse panel, select the audit categories you want. You can\n choose from reports auditing [performance](https://developer.chrome.com/docs/lighthouse/performance/performance-scoring), [accessibility](https://developer.chrome.com/docs/lighthouse/accessibility/scoring),\n [conformance with best practices](https://developer.chrome.com/docs/lighthouse/best-practices/doctype), [SEO](https://developer.chrome.com/docs/lighthouse/seo/meta-description), and [Progressive Web\n App performance](https://developer.chrome.com/docs/lighthouse/pwa/load-fast-enough-for-pwa). Click **Analyze page** to generate the reports.\n\n The reports might take a few minutes to generate.\n4. After the reports appear in the Lighthouse panel, you can review the\n findings for each audit category, or switch between audit categories by\n clicking the score and category name.\n\nUse the Debug Console\n\nFirebase Studio includes the built-in Debug Console from Code OSS. Use this\nconsole to debug your app with out-of-the-box debuggers for most common\nprogramming languages, or add a debugging extension from\n[OpenVSX](https://open-vsx.org/?category=Debuggers).\n\nTo customize your debugging experience, you can also add a `.vscode/launch.json`\nfile to your workspace and specify custom launch configurations. Learn more\nabout using launch configuration files to customize debugging at\n[Visual Studio Code debug\nconfiguration](https://github.com/microsoft/vscode-docs/blob/main/docs/debugtest/debugging-configuration.md).\n\nDebug with Gemini\n\nYou can use Gemini in Firebase to help you debug your code with\nchat in your **Code** workspace\nor the App Prototyping agent.\n\nWhile Gemini can write code for you, it might sometimes also\nproduce errors. When it detects an error, it will attempt\nto fix it. If you find that it isn't able to resolve the issue given\nthe error message, you can try some of the following techniques:\n\n- **Describe the issue:** In the chat interface, describe the\n problem you're encountering as clearly and concisely as possible.\n While Gemini might have access to context like error messages\n and logs, it might not understand the full context. Describing the behavior\n along with the error message can help Gemini fix errors\n faster.\n\n- **Ask specific questions:** Don't be afraid to ask Gemini\n direct questions about your code. For example, \"What could be causing a\n null pointer exception in this function?\" or \"How can I prevent\n this race condition?\"\n\n- **Break down complex problems:** If you're dealing with a complex\n issue, break it down into smaller, more manageable parts. Ask\n Gemini to help you debug each part separately and think\n through problems step-by-step.\n\n- **Use code fences:** When sharing code snippets, use code fences\n to ensure that the code is properly formatted. This makes it easier\n for Gemini to read and understand your code.\n\n- **Iterate and refine:** Gemini may not always provide the perfect\n solution on the first try. Review the responses, ask clarifying\n questions, and provide additional information as needed.\n\n- **Avoid prompting loops:** If Gemini gets stuck in a loop or is\n unable to answer your question, try rephrasing your prompt or\n providing additional context. Sometimes, just rewording your\n question can help Gemini understand what you're asking.\n\n If rephrasing your prompt doesn't resolve the loop, try\n the following techniques:\n - **Start a new chat:** If you're using Gemini in Firebase\n chat in your Code\n workspace, start a new chat session to reset\n Gemini's context. This can help break free from any\n misconceptions or assumptions that Gemini may have made\n in the previous conversation.\n\n - **Provide counter-examples:** If Gemini is making incorrect\n assumptions, provide counter-examples to help it understand\n the correct behavior."]]
