CMD מתקדם: הרחבה מושהית וטיפול בשגיאות אצווה

עבודה עם CMD ברמה מתקדמת זה כרוך בהרבה יותר מאשר סתם לזרוק כמה פקוד רופף: כאשר אתה מתחיל להשתמש קבצי אצווה מורכבויות, הרחבת משתנים מושהית, בקרת הרחבה וטיפול מדויק בשגיאות עושים את ההבדל בין תסריט חזק וכזה שנכשל בשקט או מכבה את הקונסולה ללא אזהרה. במאמר זה, נעמיק בנושא זה, ונחקור טריקים וניואנסים אמיתיים שלעתים קרובות אינם מופיעים במדריכים בסיסיים.

אם אי פעם חוויתם חלון נטרק אם, בעת הפעלת קובץ ה-.bat שלך, לולאת FOR אינה משתמשת בערכים הצפויים או ש-ERRORLEVEL מתנהג בצורה לא יציבה, כדאי לך להמשיך לקרוא. בואו נסקור מה פקודות כמו Setlocale, סוף מקומי, ההתרחבות המתעכבת (התרחבות מאוחרת), אופרטורים כגון || לבקרת שגיאות, וכמה דפוסים אופייניים המשמשים בסקריפטים מתקדמים, כולל דוגמאות ממשחקים או כלי עזר שמפעילים משתנים דינמיים רבים.

מה זה SETLOCAL ומדוע הוא מפתח בקבצי אצווה מתקדמים?

הפקודה SETLOCAL היא הבסיס כדי לשלוט בסביבה בתוך סקריפט אצווה ב Windowsתפקידו העיקרי הוא ליזום "היקף מקומי" של משתני סביבה שבו כל שינוי שתבצע יחדל להתקיים ברגע שהוא יופעל. סוף מקומי או שהגענו לסוף קובץ ה-.bat.

התחביר הבסיסי של SETLOCAL זה הדבר הבא, ורבות מטכניקות ה-CMD המתקדמות ביותר מבוססות עליו:

תחביר: setlocal

באמצעות תחביר זה ניתן לשלוט שני דברים חשובים מאוד: הרחבות פקודות CMD והרחבת משתני סביבה מעוכבת. שתי ההגדרות מוחלות מהנקודה בה אתה קורא SETLOCAL עד ENDLOCAL מקביל, מבלי להשפיע על התצורה הגלובלית של סשן הקונסולה מחוץ לבלוק זה.

חשוב להבין ששימוש ב-SETLOCAL מחוץ לקובץ .bat (לדוגמה, על ידי הקלדה ידנית בקונסולה האינטראקטיבית) אין לזה השפעה ממשית.מטרתו מיועדת לסקריפטים, שבהם עליך לבודד שינויים במשתנים כגון PATHנתיבים זמניים, אפשרויות היישום שלך וכו', מבלי להשאיר את סביבת המשתמש "מלוכלכת" לאחר סיום קובץ האצווה.

תכונה מרכזית של SETLOCAL זה עובד בצורה מקוננת: אפשר שיהיו לך כמה SETLOCAL y ENDLOCAL בתוך אותו סקריפט, אחד בתוך השני. כל רמה מקוננת שומרת "תמונה מהירה" של הסביבה, וכאשר היא מבוצעת ENDLOCAL המצב שלפני האחרון תמיד משוחזר SETLOCAL.

פרמטרים של SETLOCAL: הרחבות והרחבה מעוכבת

SETLOCAL יכול לקבל פרמטרים כדי להפעיל או להשבית הן הרחבות פקודות והן הרחבה מושהית של משתני סביבה. הפרמטרים הזמינים הם:

• הפעלת הרחבותמאפשר הרחבות פקודות עד ENDLOCAL תואמים, ללא קשר לאופן שבו הם היו קודם.
• השבתת הרחבות: השבת את התוספים הללו עד לתאריך הבא ENDLOCAL.
• הרחבת עיכוב מופעלת: מפעיל הרחבה מושהית של משתני סביבה.
• הרחבה מושבתת/השהתה: מבטל את ההרחבה האמורה.
• /?מציג עזרה של SETLOCAL ב- שורת הפקודה.

הרחבות פקודות CMD הם מרחיבים את ההתנהגות של פקודות קלאסיות רבות, כגון IF, FOR, SET o CALLסקריפטים מתקדמים תלויים לעתים קרובות בהרחבות אלו, ולכן נפוץ לראות בלוקים כאלה:

לדוגמה: setlocal enableextensions enabledelayedexpansion
REM aquí va el código avanzado que necesita extensiones y delayed expansion
endlocal

התרחבות מאוחרת זה בסיסי כשעובדים עם לולאות ומשתנים שמשתנים בתוך FOR או בלוקים עם סוגריים. במקום להשתמש %variable%משתמשים בסימני קריאה !variable!זה מאפשר להעריך את הערך בזמן ריצה של כל איטרציה, ולא כאשר הבלוק כולו מנותח.

פרט עדין אך שימושי מאוד הוא כי SETLOCAL משנה את המשתנה ERRORLEVEL בהתאם לשמו: אם הארגומנטים מצוינים enableextensions/disableextensions o enabledelayedexpansion/disabledelayedexpansion, רמת השגיאה מוגדרת ל-0אם ירוץ ללא פרמטרים, רמת השגיאה משתנה ל-1ניתן להשתמש בהתנהגות זו כדי לזהות אם תכונות מסוימות זמינות.

התנהגות ברמת ERRORLEVEL וזיהוי של הרחבות זמינות

משתנה ERRORLEVEL הוא המנגנון הקלאסי כדי לקבוע אם פקודה הצליחה או נכשלה. עם זאת, ל-CMD יש כמה מוזרויות כאשר הרחבות מושבתות, וקל להיתקל בהפתעות אם מניחים ש-ERRORLEVEL תמיד מתעדכן אוטומטית.

דפוס מתועד טיפוסי זה מורכב מאתחול ERRORLEVEL לערך שאינו אפס באמצעות הפקודה VERIFY עם ארגומנט לא חוקי, ומשם להשתמש SETLOCAL כדי לבדוק את היכולת להפעיל תוספים. הדוגמה הקלאסית תהיה משהו כזה:

לדוגמה: verify other 2>nul
setlocal enableextensions
if errorlevel 1 echo Unable to enable extensions

בקטע זה, מתבצעים הפעולות הבאות:ראשית, השימוש ב verify other שימוש בפרמטר שאינו נתמך מאלץ את CMD להקצות ערך שאינו אפס ל-ERRORLEVEL. לאחר מכן, SETLOCAL enableextensions עליך להגדיר את ERRORLEVEL ל-0 אם הצלחת להפעיל את ההרחבות. לכן, אם ERRORLEVEL נשאר על 1 לאחר פקודה זו, פירוש הדבר שהתוספים אינם זמינים.

הסיבה לכך היא שכאשר הרחבות פקודות מושבתותCMD לא מתאים את ERRORLEVEL בצורה הרגילה עבור פעולות מסוימות. לכן הטריק הקטן הזה נחוץ מראש. verifyבסקריפטים חזקים שצריכים לפעול בסביבות "מוגבלות" או מדור קודם, סוג זה של בדיקה יכול להיות שימושי מאוד.

כמו כן, שים לב ש-SETLOCAL נמצא מחוץ לקובץ אצווה. זה לא יעזור לך לנהל את ERRORLEVEL בסשן אינטראקטיבי, מכיוון שאפקט לוקליזציה של הסביבה מיועד רק להקשר של ביצוע סקריפט.

דוגמה מעשית של SETLOCAL: שינוי זמני של PATH

אחד היישומים האופייניים ביותר של SETLOCAL זה נוגע במשתנה PATH בתוך קובץ .bat כדי להפעיל יישום עזר או סקריפט, אך מבלי להשאיר את השינוי הזה פעיל למשך שארית ההפעלה.

דוגמה לסקריפט מלאפקודה שמפעילה תוכנית רשת "superapp", מפנה את הפלט שלה לקובץ, ולאחר מכן פותחת את הקובץ הזה ב-Notepad, עשויה להיראות כך:

סקריפט לדוגמה: rem *Begin Comment
rem Este programa inicia el programa por lotes superapp en la red,
rem redirige la salida a un archivo y muestra el archivo
rem en el Bloc de notas.
rem *End Comment
@echo off
setlocal
set path=g:\programs\superapp;%path%
call superapp > c:\superapp.out
endlocal
start notepad c:\superapp.out

בסקריפט זה, כל שינויי ה-PATH מוגבלים לבלוק המוגן על ידי SETLOCAL y ENDLOCALמחוץ לקטע זה, סביבת המשתמש (כולל PATH) נשארת ללא שינוי. דפוס זה נמצא בשימוש נרחב בעת שילוב כלים של צד שלישי מבלי לרצות "למלא" את הסביבה הכוללת.

שימו לב גם לשימוש ב-CALL להוציא להורג superappזה מאפשר לזרימת קובץ האצווה להמשיך כרגיל לאחר השלמתו, להפנות את הפלט לקובץ ולבסוף להפעיל את Notepad כדי להציג אותו.

טיפול בשגיאות אצווה: ERRORLEVEL, IF והאופרטור ||

בסקריפטים של אצווה, טיפול שגיאות קלאסי זה כרוך בבדיקת ERRORLEVEL מיד לאחר כל פקודה "קריטית". סכימה נפוצה מאוד היא כדלקמן:

תבנית: copy blah ..\test
if %errorlevel% neq 0 exit /b %errorlevel%

מה שאנחנו עושים כאן זה להריץ עותק ואם ERRORLEVEL אינו שווה ל-0, יש לצאת מהסקריפט ולחזור על אותו קוד שגיאה. זוהי הגישה המפורשת והתואמת ביותר, אך היא מתחילה למלא את הסקריפט בבלוקים חוזרים של IF שמקשים על קריאתו.

כדי לנקות את הקוד, משתמשים מתקדמים רבים אימצו את האופרטור הלוגי ||אופרטור זה מבצע את הפקודה השנייה רק ​​אם הראשונה נכשלת (כלומר, אם ERRORLEVEL שלה אינו אפס). ניתן לקצר את הדוגמה הקודמת ל:

צורה קומפקטית: copy blah ..\test || exit /b %errorlevel%

שורה אחת זו מבטאת בדיוק את אותה כוונהאם ההעתקה נכשלת, צא מהסקריפט והחזר את השגיאה. הוא קומפקטי יותר, קל יותר לקריאה, ובדרך כלל אלגנטי יותר. המקבילה החיובית של האופרטור היא &&, אשר מבצע את הפקודה השנייה רק ​​אם הראשונה מצליחה.

אלו שמשתמשים בסקריפטים של אצווה מדי יום הם בדרך כלל מעדיפים את הגרסה עם || לשם הבהירות, אלא אם כן אתם זקוקים לתאימות עם גרסאות CMD ישנות מאוד או סביבות ללא הרחבות. בפועל, במערכות Windows מודרניות, אופרטור זה פועל בצורה מושלמת ומפשט מאוד את הטיפול בשגיאות.

חלונות שנסגרים: כיצד לאבחן ולמנוע זאת

בעיה נפוצה מאוד בעת הפעלת קבצי .bat כשלוחצים פעמיים, נפתחת קונסולה, משהו רץ מהר מאוד, והחלון נסגר, בלי לתת לך זמן לראות מה קרה. לפעמים אפילו תוכן קובץ האצווה לא רץ כראוי.

משתמשים רבים מנסים לתקן זאת באמצעות PAUSE או CMD /Kעם זאת, זה לא תמיד עובד, במיוחד אם הסקריפט מכיל שגיאות תחביר חמורות, נתיבים שגויים או פקודות מוקדמות שבורות. Windows 11 (וגרסאות דומות), באגים מסוימים גורמים ל-CMD להסתיים באופן מיידי מבלי להציג הודעות ברורות.

כדי לפתור מקרים אלה, מומלץ פתחו שורת פקודה באופן ידני (Win+R → cmd) והפעילו את קובץ ה-.bat משם על ידי הקלדת הנתיב שלו. בדרך זו, גם אם הסקריפט נכשל, שורת הפקודה תישאר פתוחה, ותאפשר לכם לקרוא הודעות שגיאה, פלט אבחון או אפילו להוסיף שורות. echo עבור עקבות פנימיים.

נוהג טוב נוסף הוא להפעיל את ECHO בתחילת הסקריפט בזמן ניפוי שגיאות (@echo on) ולבטל אותו לאחר פתרון הבעיות (@echo offזה מאפשר לך לראות אילו פקודות מבוצעות בפועל, באיזה סדר ועם אילו פרמטרים.

טיפול מתקדם בשגיאות: דפוסים מעשיים

מעבר לשימוש ישיר ב-ERRORLEVEL מאחורי כל פקודה, ישנם דפוסים חוזרים שעוזרים להפוך את הקוד לקריא וחזק יותר. כמה דוגמאות:

• שרשור פקודות עם && ו- ||: comando1 && comando2 || comando3 כדי לבטא "אם פקודה 1 עובדת כשורה, בצע את פקודה 2; אם היא נכשלת, בצע את פקודה 3".
• פונקציות המסומנות ב-EXIT /Bסוג תת-שגרות call :MiFuncion אשר מחזירים קודי שגיאה ספציפיים, שנבדקו לאחר מכן עם if errorlevel.
• אתחול מפורש של ERRORLEVEL לפני סעיפים קריטיים, כדי לא להעביר שגיאות ישנות.

ניתן גם לטפל בשגיאות בצורה מרוכזת בעל תווית משותפת, למשל :ErrorFatal, אליו ניתן לגשת באמצעות goto o call כאשר משהו משתבש, הצגת מסרים ברורים וסגירת משאבים במידת הצורך (קבצים זמניים, שינויים בספריות וכו').

בכל מקרה, ההחלטה בין שימוש ב-IF ERRORLEVEL או המפעיל || זה תלוי הרבה בסגנון האישי וברמת ההתאמה שאתה מחפש. ברוב התרחישים הנוכחיים, הדרך עם || זה לא רק תקף, אלא גם רצוי לשם הבהירות.

הרחבה וביצועים מושהים בסקריפטים מורכבים

בעת עבודה עם מבנים מורכבים, כגון משחקים או ממשקי קונסולות "גרפיים" (לדוגמה, שולה מוקשים קבוצתית), הרחבה מושהית הופכת חיונית. במקרים אלה, נעשה שימוש במטריצות מדומות עם משתנים מהסגנון. bויש צורך לעדכן ולהציג את הסטטוס בלולאות תכופות מאוד.

דוגמה אופיינית במשחק שולה מוקשים מיושם במצב אצווה, זה יכלול מעבר על הלוח ובניית שורות עם מידע מכל תא. עיבוד מקדים של שורות עשוי להיראות בערך כך (מותאם לשימוש נפוץ):

רסיס: for /l %%g in (0,1,!width!) do (
set "row=!row!!b!!d!"
)
for %%g in ("!widthx!") do (
set "row=!row!!b!"
)

כאן, מנוצלת ההתרחבות העיכובה. (קריאות הקריאה) !row!, !b!וכו') כדי לשרשר תוכן דינמי למשתנה המייצג שורת לוח. ללא הרחבה מושהית, יהיה בלתי אפשרי לבנות מחרוזות אלו בצורה נכונה בתוך הלולאה.

הבעיה שבדרך כלל מופיעה בלוחות גדולים זה עניין של ביצועים: אם כל עדכון כולל מאות פקודות setהקונסולה הופכת לאיטית באופן ניכר. חלק מהמשתמשים מנסים "לעבד מראש" את השורות למשתנים ואז להוציא הכל בבת אחת, אך מגלים שהפלט מתפרש כטקסט רגיל במקום כ"קוד בר ביצוע".

נקודה זו היא המפתח: CMD אינו מעריך את תוכן המשתנה כאילו היה סקריפט חדש אלא אם כן נעשה שימוש בטכניקה עקיפה כלשהי (לדוגמה, כתיבה לקובץ .bat ולאחר מכן קריאה אליו באמצעות call), כך שניסיון לגרום למשתנה עם "קוד" להתבצע ישירות לא עובד כצפוי בשפות אחרות.

אסטרטגיה נוספת לשיפור ביצועים זה כרוך במזעור פעולות המשפיעות על ניתוח מורכב (כגון הפניות הרחבה מושהות רבות בתוך לולאות עמוקות), ובמקום זאת חישוב מוקדם של חלקים סטטיים או חצי סטטיים מחוץ ללולאות קריטיות. עם זאת, במסגרת המגבלות של CMD, שולה מוקשים עם מאות תאים תמיד יישא בעונש מסוים.

דוגמה לפונקציית תצוגת לוח מחוונים עם הרחבה מושהית

פונקציית לוח ציור משחק שולה מוקשים קבוצתי יכול לכלול מספר שכבות של לוגיקה: שינוי מיקום הסמן, סימון זמני של התא שנבחר, בניית הייצוג שורה אחר שורה, ולאחר מכן שחזור הערכים המקוריים. דוגמה גסה עשויה להיות:

שגרה משוערת: :board
echo %esc%==]"
set "board="
for /l %%g in (0,1,!height!) do (
set "board=!board!!row!!lf!"
)
echo !board!
set "b= "
set "b= "
exit /b

שגרה זו כוללת את הדברים הבאים: הסמן זז לפינה השמאלית העליונה (באמצעות רצף בריחה המאוחסן ב %esc%), מחושבים מדדי עזר (temp_var), מפרידים חזותיים מסומנים במטריצה bהשרשרת בנויה board שרשור שורות ומעברי שורה שעברו עיבוד מראש (!lf!), הכל מודפס בבת אחת ולאחר מכן המשתנים משוחזרים למצבם המקורי.

השאלה שעולה בדרך כלל כאן מדובר על איך להבטיח שעיבוד שורות מקדים לא רק יוצר טקסט, אלא גם מתפרש כפקודות או מעדכן ביעילות את הלוח. ב-CMD, תוכן משתנה אינו מוערך מחדש אוטומטית כקוד, כך שהפתרון כרוך בשינוי הגישה: צמצום מספר... set y echo על ידי עדכון וקיבוץ הפלט ככל האפשר, כפי שעושה התבנית הקודמת עם המשתנה board.

אסטרטגיה נוספת לשיפור ביצועים זה כרוך במזעור פעולות המשפיעות על ניתוח מורכב (כגון הפניות הרחבה מושהות רבות בתוך לולאות עמוקות), ובמקום זאת חישוב מוקדם של חלקים סטטיים או חצי סטטיים מחוץ ללולאות קריטיות. עם זאת, במסגרת המגבלות של CMD, שולה מוקשים עם מאות תאים תמיד יישא בעונש מסוים.

שגיאות עיבוד ותווים מיוחדים

בכתבים גדולים, מתעוררת בעיה נפוצה נוספת. אלו הם התווים המיוחדים: סוגריים, הפניות, מרכאות, סימני קריאה וכו'. בעיות קידודבעת שימוש בהרחבה מאוחרת ובלולאות מקוננות, תווים אלה עלולים לשבש את ניתוח הפקודות אם לא מבצעים עליהם תזמון בריחה כהלכה.

לדוגמה, סוגר סוגר בלתי צפוי זה יכול לגרום לשגיאות כגון "פקודה זו אינה נתמכת" או פשוט לבטל את ביצוע הבלוק. כדי להימנע מכך, עליך להיות זהיר מאוד בעת בניית שורות עם echo שמכילים סוגריים או סמלים של הקליפה, ולהסתמך על טכניקות כגון echo( או שכפול של דמויות מסוימות לצורך מילוט.

במסמכים מיוחדים על אצווה מתקדמת בדרך כלל כלולים טבלאות של "תווים מיוחדים" והערות כיצד לברוח מהם בהקשרים שונים (בתוך לולאות FOR, בבלוקים עם סוגריים, עם הרחבה מאוחרת פעילה וכו'). למרות שלא ניכנס לפרטים על כל אחד מהם כאן, כדאי לזכור שככל שהסקריפט מורכב יותר, כך כדאי יותר לבדוק אותו שלב אחר שלב ולסקור בקפידה את אופן הטיפול בסמלים אלה.

כמו כן, מקובל למצוא טכניקות מורכבות מאוד שמשלבים CMD עם שפות או כלים אחרים (כגון VBScript או PowerShell) כתיבת קטעים קטנים לקבצים זמניים והפעלתם, תוך ניצול הטוב ביותר של כל סביבה. במקרים אלה, זהירות עם תווים מיוחדים והפניות הופכת חשובה אף יותר.

פונקציות, תת-שגרות ומבנים מתקדמים בעיבוד אצווה

עולם המינון המתקדם זה לא מוגבל לפקודות מבודדות: יש מערכת אקולוגית שלמה של תבניות לבניית פונקציות רב פעמיות, סימולציית מערכים, טיפול בארגומנטים והחזרת תוצאות. הנוהג הרגיל הוא להשתמש בתגים (:MiFuncion) והפקודה call, ו ליצור תפריטים אינטראקטיביים:

לדוגמה: @echo off
call :FunctionX
rem Más código aquí
exit /b 0

:פונקציהX
טיפול בשגיאות בתוך הפונקציה
זכור …
יציאה /b 0

תת-שגרות אצווה הם מאפשרים את הכימוס של לוגיקה מורכבת, בין היתר, המרת מקטעים חוזרים (כגון בדיקת שגיאות, מניפולציה של מחרוזות או מניפולציה של קבצים) לבלוקים הניתנים לקריאה. exit /b ניתן להחזיר ERRORLEVEL ספציפי למתקשר, אשר לאחר מכן נבדקת באמצעות if errorlevel או עם מפעילים כמו ||.

ישנן טכניקות אפילו יותר מתקדמות כאשר זרמי נתונים חלופיים (ADS) משמשים לאחסון קוד עזר המשויך לקובץ .bat עצמו, או כאשר מקטעים בשפות אחרות כמו VBScript מעורבבים באותו קובץ. אלה טריקים הם מאפשרים הרחבת יכולות אצווה, אך הם גם מסבכים תחזוקה וניפוי שגיאות, ולכן הם בדרך כלל שמורים לתרחישים ספציפיים מאוד.

במדריכים רבים ומקיפים לכתיבת סקריפטים באצווה נושאים כגון יצירת קבצים דינמיים ושימוש בהם מכוסים גם כן. pushd y popd לנהל באופן מאובטח ספריות, מניפולציה של ארגומנטים (%1, %2וכו'), והבדלים עדינים בין .BAT ו-.CMD. כל זה מרוויח מאוד מבקרת סביבה טובה עם SETLOCAL/ ENDLOCAL וטיפול שיטתי בתקלות.

לשלוט התרחבות מאוחרת, הנהלת רמת שגיאה והשימוש האסטרטגי של Setlocale זה מה שמבדיל בין סקריפטים של אצווה "ביתית" לבין אלו שניתן להשתמש בהם בפועל לאוטומציה מורכבת ואמינה, בין אם עבור כלים פנימיים, כלי עזר למערכת או אפילו משחקי קונסולה קטנים וניסויים.