پایتون در ۱ ساعت — مخصوص وایب کدینگ

📋 قبل از شروع — این آموزش با چه فرض‌هایی نوشته شده؟

فرض کرده‌ایم کامپیوترت ویندوز دارد و فقط بلدی روشنش کنی، کلیک کنی و تایپ کنی. همین کافی است!
هدف این آموزش برنامه‌نویس‌شدنِ حرفه‌ای در یک ساعت نیست (چنین چیزی ممکن نیست!). هدف این است که آن‌قدر پایتون بفهمی که بتوانی با کمک هوش مصنوعی کد بگیری، بخوانی‌اش، اجرایش کنی و خطاهایش را درست کنی. به این سبک کارکردن می‌گویند «وایب کدینگ»^۱.
هر مرحله حدود ۵ دقیقه وقت می‌گیرد. عجله نکن؛ اگر بیشتر طول کشید هیچ اشکالی ندارد.

📖 پاورقی ۱ — «وایب کدینگ» (Vibe Coding) یعنی چه؟ یعنی به‌جای این‌که خودت خط‌به‌خط کد بنویسی، به یک هوش مصنوعی (مثل Claude یا ChatGPT) به زبان خودت می‌گویی چه می‌خواهی، او کد را می‌نویسد، و تو آن را می‌خوانی، اجرا می‌کنی و با چند پیام رفت‌وبرگشتی کاملش می‌کنی. مثل این است که یک آشپز ماهر کنارت باشد و تو فقط سفارش بدهی و غذا را بچشی — ولی برای این‌که سفارشِ درست بدهی، باید اسم مواد اولیه را بلد باشی!

پیش‌نیازها: پایتون را روی کامپیوترت بیاور 🧰

مرحله ۱ از ۱۲⏱️ ~۷ دقیقه

برای این‌که کد پایتون اجرا شود، کامپیوترت باید «زبان پایتون» را بلد باشد. این یعنی باید یک برنامهٔ رایگان به اسم Python را نصب کنیم. مثل این است که برای خواندن یک کتاب فرانسوی، اول باید یک مترجم فرانسوی استخدام کنی!

مرورگر اینترنتت (مثلاً Chrome یا Edge) را باز کن.

در نوار آدرس بالای مرورگر تایپ کن: python.org و کلید Enter را بزن.

در سایت، دنبال دکمه یا منویی به اسم Downloads بگرد و رویش کلیک کن. (ممکن است ظاهر سایت کمی فرق کند، ولی کلمهٔ Downloads همیشه هست.)

روی دکمهٔ زردرنگِ بزرگ که نوشته Download Python و یک شماره کنارش دارد کلیک کن تا فایل نصب دانلود شود.

وقتی دانلود تمام شد، روی فایل دانلودشده دوبار کلیک کن تا پنجرهٔ نصب باز شود.

⚠️ خیلی مهم: در اولین صفحهٔ نصب، پایینِ پنجره یک تیک هست با نوشته‌ای شبیه Add python.exe to PATH. حتماً این تیک را بزن.

حالا روی Install Now کلیک کن و صبر کن تا نصب تمام شود. اگر ویندوز پرسید «اجازه می‌دهی تغییر ایجاد شود؟» روی Yes کلیک کن.

وقتی نوشت Setup was successful، پنجره را ببند. تمام! 🎉

💡 نکته همراه پایتون، یک برنامهٔ سادهٔ کدنویسی به اسم IDLE هم خودبه‌خود نصب می‌شود. در کل این آموزش از همین استفاده می‌کنیم — چیز دیگری لازم نیست نصب کنی.

📖 پاورقی — PATH یعنی چه؟ «پَث» مثل دفترچه‌تلفنِ ویندوز است. وقتی تیکش را می‌زنی، یعنی به ویندوز می‌گویی: «شمارهٔ پایتون را در دفترچه‌ات ذخیره کن تا هر وقت صدایش زدم، پیدایش کنی.» اگر این تیک را نزنی، بعداً ویندوز پایتون را گم می‌کند!

✅ ایست بازرسی روی دکمهٔ استارت ویندوز (پایین-گوشهٔ صفحه) کلیک کن و تایپ کن: IDLE — باید برنامه‌ای با آیکون پایتون در نتایج ببینی. اگر دیدی، عالی است! اگر ندیدی، برو به بخش رفع اشکال، مشکل شمارهٔ ۱.

پایتون چیست و وایب کدینگ چطوری کار می‌کند؟ 🧠

مرحله ۲ از ۱۲⏱️ ~۳ دقیقه

پایتون یک زبان برنامه‌نویسی^۲ است؛ یعنی زبانی که با آن به کامپیوتر دستور می‌دهیم. کامپیوتر مثل یک آشپزِ خیلی سریع ولی خیلی حرف‌گوش‌کن است: دقیقاً همان کاری را می‌کند که نوشته‌ای — نه یک ذره بیشتر، نه یک ذره کمتر، و اگر جمله‌ات غلط املایی داشته باشد، قهر می‌کند و خطا می‌دهد!

پایتون محبوب‌ترین زبان دنیا برای شروع است، چون کدهایش شبیه جملهٔ انگلیسیِ ساده است و هوش مصنوعی‌ها هم در نوشتنِ آن فوق‌العاده‌اند. برای همین بهترین زبان برای وایب کدینگ است.

📖 پاورقی ۲ — «زبان برنامه‌نویسی» یعنی چه؟ کامپیوتر فارسی و انگلیسی معمولی را نمی‌فهمد. زبان برنامه‌نویسی یک زبانِ قراردادیِ ساده با قواعد خیلی دقیق است که هم ما می‌توانیم بنویسیمش، هم کامپیوتر می‌تواند اجرایش کند.

در وایب کدینگ، چرخهٔ کارِ تو همیشه این ۴ قدم است. این شکل را خوب به خاطر بسپار — کل این آموزش برای این است که بتوانی این چرخه را بچرخانی:

🤔 چرا باید کدخواندن یاد بگیرم وقتی هوش مصنوعی می‌نویسد؟ چون قدم‌های ۲ و ۴ (بخوان و اصلاح کن) گردنِ خودت است! اگر کد را نفهمی، مثل کسی هستی که با تاکسی به شهر غریبه رفته: تا وقتی راننده درست برود مشکلی نیست، ولی اگر راه را اشتباه برود، اصلاً متوجه نمی‌شوی. مراحل ۳ تا ۱۰ این آموزش دقیقاً «نقشه‌خوانی» را یادت می‌دهد.

اولین کدت را اجرا کن ▶️

مرحله ۳ از ۱۲⏱️ ~۵ دقیقه

وقتش است اولین دستور را به کامپیوتر بدهی. از برنامهٔ IDLE استفاده می‌کنیم که همراه پایتون نصب شد.

روی دکمهٔ استارت ویندوز کلیک کن و تایپ کن: IDLE

روی برنامهٔ IDLE که در نتایج ظاهر شد کلیک کن تا باز شود. یک پنجرهٔ سفید با چند خط نوشتهٔ انگلیسی و علامت >>> می‌بینی. این پنجره «پوسته»^۳ نام دارد.

جلوی علامت >>> این را دقیقاً همین‌طوری تایپ کن (همهٔ حروف کوچک، با پرانتز و گیومه):

print("Salam Donya!")

کلید Enter را بزن.

🖥️ چیزی که باید ببینی:

Salam Donya!

تبریک! 🎉 تو الان به کامپیوتر دستور دادی و او اطاعت کرد. بیا کد را کالبدشکافی کنیم:

تکه	یعنی چه؟
`print`	اسم یک دستور آماده است، یعنی «چاپ کن / نشان بده». (ربطی به پرینترِ کاغذی ندارد؛ یعنی روی صفحه نمایش بده.)
`( )`	پرانتزها مثل دهانِ دستورند: هر چه می‌خواهی به دستور بدهی، داخلشان می‌گذاری.
`"Salam Donya!"`	گیومه‌ها یعنی «این یک متن است، همین‌طوری نمایشش بده و سعی نکن معنی‌اش کنی».

📖 پاورقی ۳ — «پوسته» (Shell) چیست؟ جایی است که هر خط کدی بنویسی، همان لحظه اجرا می‌شود. مثل ماشین‌حسابِ گفتگویی: می‌گویی، جواب می‌دهد. برای تمرین عالی است. برنامه‌های واقعی را در «فایل» می‌نویسند که در مرحلهٔ آخر یاد می‌گیری.

⚠️ مواظب باش پایتون به کوچکی و بزرگیِ حروف حساس است! print درست است ولی Print یا PRINT خطا می‌دهد. همچنین گیومه و پرانتزِ باز باید حتماً بسته شوند — مثل درِ یخچال!

✅ ایست بازرسی حالا خودت این را امتحان کن: print(2 + 3) — باید عدد 5 را ببینی. دقت کن این‌بار گیومه نگذاشتیم، چون می‌خواستیم پایتون حساب کند، نه این‌که متنِ «2 + 3» را نشان بدهد. اگر جواب نگرفتی، برو به بخش رفع اشکال، مشکل شمارهٔ ۲.

متغیرها: جعبه‌های اسم‌دار 📦

مرحله ۴ از ۱۲⏱️ ~۵ دقیقه

تصور کن یک قفسه پر از جعبه داری و روی هر جعبه یک برچسبِ اسم چسبانده‌ای: «اسباب‌بازی»، «مداد»، «پول‌توجیبی». هر وقت چیزی لازم داشتی، با اسمش صدایش می‌زنی. در برنامه‌نویسی به این جعبه‌ها می‌گویند متغیر^۴ — و این مهم‌ترین چیزی است که در هر کدی می‌بینی.

در پوستهٔ IDLE این سه خط را یکی‌یکی تایپ کن (بعد از هر خط Enter بزن):

name = "Sara"
age = 12
print(name)

🖥️ چیزی که باید ببینی:

Sara

تکه	یعنی چه؟
`name = "Sara"`	یک جعبه به اسم name بساز و متنِ Sara را داخلش بگذار.
`=`	⚠️ در پایتون علامت مساوی یعنی «بگذار داخلِ»، نه «برابر است با»! جهتش همیشه از راست به چپ است: چیزِ سمت راست می‌رود داخل جعبهٔ سمت چپ.
`print(name)`	محتوای جعبهٔ name را نشان بده. چون گیومه ندارد، پایتون می‌فهمد «name» اسم یک جعبه است، نه یک متن.

💡 نکتهٔ طلایی برای وایب کدینگ در کدهایی که هوش مصنوعی می‌نویسد، تقریباً هر خطی که یک = وسطش دارد، دارد یک جعبه می‌سازد یا محتوایش را عوض می‌کند. اسم جعبه‌ها معمولاً معنی‌دار است: total_price یعنی «قیمت کل»، user_name یعنی «نام کاربر». همین اسم‌خوانی، نصفِ فهمیدنِ کد است!

📖 پاورقی ۴ — «متغیر» (variable) یعنی جایی در حافظهٔ کامپیوتر که یک اسم دارد و می‌شود چیزی داخلش نگه داشت. «متغیر» است چون محتوایش می‌تواند تغییر کند: اگر بعداً بنویسی age = 13، محتوای قبلی دور ریخته می‌شود و ۱۳ جایش می‌نشیند.

✅ ایست بازرسی این را امتحان کن: print(age + 1) — باید 13 را ببینی. یعنی پایتون رفت داخل جعبهٔ age، عدد ۱۲ را برداشت و یکی به آن اضافه کرد.

انواع داده: عدد، متن، بله/خیر 🔢🔤

مرحله ۵ از ۱۲⏱️ ~۵ دقیقه

همان‌طور که در آشپزخانه، مایعات را در بطری می‌ریزیم و برنج را در کیسه، در پایتون هم هر «جنس» از اطلاعات، نوعِ خودش را دارد. ۴ نوعِ اصلی که در ۹۰٪ کدها می‌بینی این‌ها هستند:

نوع	اسم انگلیسی در کد	مثال	یعنی چه؟
عدد صحیح	`int`	`42`	عدد بدون اعشار. برای شمردن.
عدد اعشاری	`float`	`3.14`	عدد با ممیز. برای اندازه‌گیری. (به‌جای ممیزِ فارسی از نقطه استفاده می‌شود.)
متن / رشته	`str`	`"salam"`	هر چیزی داخل گیومه. حتی `"42"` با گیومه یک متن است، نه عدد!
بولی (بله/خیر)	`bool`	`True` / `False`	فقط دو حالت دارد: درست یا غلط. مثل کلید برق: روشن یا خاموش.

یک ترفند فوق‌العاده کاربردی: می‌توانی متن و متغیر را قاطی کنی. به این می‌گویند اِف-اِسترینگ^۵ و هوش مصنوعی‌ها عاشقش هستند — تقریباً در هر کدی می‌بینی‌اش:

name = "Sara"
age = 12
print(f"Salam {name}! To {age} sal dari.")

🖥️ چیزی که باید ببینی:

Salam Sara! To 12 sal dari.

📖 پاورقی ۵ — f-string چیست؟ اگر قبل از گیومهٔ اول یک حرف f بگذاری، هر چیزی که داخل متن بین آکولاد { } بنویسی، پایتون آن را «جای خالی» حساب می‌کند و محتوای متغیر را جایش می‌گذارد. مثل کارت دعوتی که جای اسم مهمان خالی گذاشته‌اند و برای هر نفر اسمش را می‌نویسند.

⚠️ مواظب باش "5" + "5" می‌شود "55" (دو متن به هم چسبیدند!) ولی 5 + 5 می‌شود 10. یکی از خطاهای رایجی که در وایب کدینگ می‌بینی همین قاطی‌شدن متن و عدد است.

✅ ایست بازرسی بنویس: print(f"2 + 2 = {2 + 2}") — باید ببینی: 2 + 2 = 4. یعنی داخل آکولاد حتی می‌شود حساب‌وکتاب هم کرد!

لیست و دیکشنری: جعبه‌های چندطبقه 🗂️

مرحله ۶ از ۱۲⏱️ ~۶ دقیقه

گاهی یک جعبه برای یک چیز کافی نیست؛ می‌خواهی یک فهرست خرید داشته باشی. در پایتون به آن لیست می‌گویند و با کروشه [ ] ساخته می‌شود:

kharid = ["nan", "shir", "panir"]
print(kharid[0])
print(len(kharid))

🖥️ چیزی که باید ببینی:

nan 3

تکه	یعنی چه؟
`["nan", "shir", "panir"]`	یک لیست با ۳ عضو. عضوها با ویرگول انگلیسی جدا می‌شوند.
`kharid[0]`	عضو شمارهٔ ۰ از لیست، یعنی اولین عضو! ⚠️ پایتون از صفر می‌شمارد، نه از یک. عضو دوم می‌شود `kharid[1]`.
`len(kharid)`	«طول» لیست، یعنی تعداد عضوهایش. len مخفف length (طول) است.

و گاهی می‌خواهی هر چیزی یک برچسب داشته باشد، مثل دفترچه‌تلفن: اسمِ آدم ← شماره‌اش. به این می‌گویند دیکشنری و با آکولاد { } ساخته می‌شود:

daneshamooz = {"name": "Sara", "nomre": 19}
print(daneshamooz["name"])

🖥️ چیزی که باید ببینی:

Sara

در دیکشنری، هر خانه دو بخش دارد: کلید (سمت چپِ دونقطه، مثل "name") و مقدار (سمت راست، مثل "Sara"). با کلید، مقدار را پیدا می‌کنی — درست مثل این‌که در دفترچه‌تلفن با اسمِ آدم، شماره‌اش را پیدا می‌کنی.

💡 نکتهٔ وایب کدینگ هر وقت در کدِ هوش مصنوعی [ ] دیدی بگو «آها، فهرست!» و هر وقت { } با دونقطه دیدی بگو «آها، دفترچه‌تلفن!». اطلاعاتی که از اینترنت یا فایل‌ها می‌آید (مثل قیمت‌ها، کاربرها، تنظیمات) تقریباً همیشه به شکل همین دوتاست.

✅ ایست بازرسی بنویس print(kharid[2]) — باید panir را ببینی (عضو سوم، چون شمارش از صفر است!). اگر خطای قرمز دیدی، برو رفع اشکال، مشکل شمارهٔ ۳.

شرط‌ها: اگر... آن‌گاه... 🚦

مرحله ۷ از ۱۲⏱️ ~۵ دقیقه

برنامه‌ها باید بتوانند تصمیم بگیرند، مثل خودِ ما: «اگر باران می‌بارد، چتر بردار؛ وگرنه عینک آفتابی بزن.» در پایتون این کار با if (اگر) و else (وگرنه) انجام می‌شود:

nomre = 15
if nomre >= 10:
    print("Ghabool shodi!")
else:
    print("Dobare talash kon.")

🖥️ چیزی که باید ببینی:

Ghabool shodi!

⚠️ دو قانون خیلی مهم که کلِ پایتون روی آن‌ها سوار است ۱) خطِ if همیشه با دونقطه : تمام می‌شود. دونقطه یعنی «حالا می‌گویم در این صورت چه‌کار کن...».
۲) خط‌های بعدی که کمی تورفته‌اند (۴ تا فاصله از اول خط)، «داخلِ» آن شرط هستند. به این تورفتگی می‌گویند ایندنت^۶. مثل این است که زیرمجموعه‌های یک فهرست را کمی تو می‌نویسی. اگر تورفتگی را بردارید یا کم‌وزیاد کنید، پایتون خطا می‌دهد یا کار اشتباهی می‌کند!

📖 پاورقی ۶ — «ایندنت» (indent) یعنی تورفتگی در بیشتر زبان‌ها تورفتگی فقط برای خوشگلی است، ولی در پایتون معنی دارد: مشخص می‌کند کدام خط‌ها «داخل» کدام دستورند. وقتی کد هوش مصنوعی را می‌خوانی، به تورفتگی‌ها مثل پلکان نگاه کن: هر چه تورفته‌تر، یعنی «داخل‌تر».

علامت‌های مقایسه که در شرط‌ها می‌بینی:

علامت	یعنی	مثال
`==`	آیا برابر است؟ (دقت کن: دو تا مساوی! یک مساوی یعنی «بگذار داخل جعبه»)	`age == 12`
`!=`	آیا نابرابر است؟	`name != "Ali"`
`>` و `<`	بزرگ‌تر / کوچک‌تر	`nomre > 10`
`>=` و `<=`	بزرگ‌تر یا مساوی / کوچک‌تر یا مساوی	`nomre >= 10`
`and` / `or`	و / یا — برای ترکیب دو شرط	`age > 8 and age < 13`
`elif`	«وگرنه اگر» — شرطِ وسطی، بین `if` و `else`	—

✅ ایست بازرسی در پوسته مقدار را عوض کن: nomre = 8 و بعد همان بلوکِ if بالا را دوباره بنویس (در پوسته، بعد از خطِ تورفته یک Enter اضافه بزن تا اجرا شود). این‌بار باید Dobare talash kon. را ببینی.

حلقه‌ها: تکرارِ خودکار 🔁

مرحله ۸ از ۱۲⏱️ ~۵ دقیقه

فرض کن معلم گفته «برای تک‌تکِ بچه‌های کلاس یک کارت تبریک بنویس». تو که ۳۰ بار جملهٔ جدا نمی‌نویسی؛ یک الگو داری و برای هر نفر تکرارش می‌کنی. در پایتون به این می‌گویند حلقه و با for ساخته می‌شود:

kharid = ["nan", "shir", "panir"]
for chiz in kharid:
    print(f"Yadet nare: {chiz}")

🖥️ چیزی که باید ببینی:

Yadet nare: nan Yadet nare: shir Yadet nare: panir

ترجمهٔ خطِ for chiz in kharid: به فارسی می‌شود: «برای هر چیز در لیستِ خرید، کارهای تورفتهٔ زیر را انجام بده.» متغیرِ chiz در هر دور، یکی از عضوهای لیست می‌شود: دور اول nan، دور دوم shir و همین‌طور تا آخر.

اگر لیست نداری و فقط می‌خواهی چیزی مثلاً ۵ بار تکرار شود، از range استفاده می‌شود:

for i in range(5):
    print(f"Dor {i}")

🖥️ چیزی که باید ببینی:

Dor 0 Dor 1 Dor 2 Dor 3 Dor 4

💡 نکتهٔ وایب کدینگ range(5) اعداد ۰ تا ۴ را می‌دهد (باز هم شمارش از صفر، و خودِ ۵ حساب نمی‌شود!). در کدهای هوش مصنوعی هر جا for دیدی، در ذهنت بگو: «این تکه، برای همهٔ عضوها تکرار می‌شود.» یک نوع حلقهٔ دیگر هم هست به اسم while که یعنی «تا وقتی که شرط برقرار است، تکرار کن» — مثل «تا وقتی ظرف‌ها تمام نشده، بشور!».

✅ ایست بازرسی یک حلقه بنویس که اعداد ۰ تا ۲ را چاپ کند: for i in range(3): و در خط تورفتهٔ بعد print(i). باید ۰ و ۱ و ۲ را زیر هم ببینی.

تابع‌ها: دستورپخت‌های آماده 👨‍🍳

مرحله ۹ از ۱۲⏱️ ~۶ دقیقه

تابع^۷ مثل یک دستورپختِ اسم‌دار است: یک بار می‌نویسی «چطور کیک درست کنیم»، بعد هر وقت خواستی فقط می‌گویی «کیک درست کن!» و لازم نیست دستورپخت را دوباره بنویسی. کدهای هوش مصنوعی پر از تابع هستند، پس این مرحله خیلی مهم است:

def salam_kon(name):
    print(f"Salam {name} jan!")

salam_kon("Sara")
salam_kon("Ali")

🖥️ چیزی که باید ببینی:

Salam Sara jan! Salam Ali jan!

تکه	یعنی چه؟
`def`	مخفف define یعنی «تعریف کن». دارد یک دستورپخت جدید می‌سازد — هنوز اجرایش نمی‌کند!
`salam_kon`	اسمی که خودمان برای دستورپخت انتخاب کردیم.
`(name)`	«موادِ لازم» دستورپخت. این تابع یک ماده لازم دارد: یک اسم. به آن «ورودی» یا «پارامتر» می‌گویند.
خط‌های تورفته	بدنهٔ دستورپخت — کارهایی که موقع اجرا انجام می‌شود.
`salam_kon("Sara")`	«صدازدنِ» تابع، یعنی: حالا دستورپخت را با مادهٔ «سارا» اجرا کن! تا صدایش نزنی، هیچ اتفاقی نمی‌افتد.

تابع‌ها می‌توانند به‌جای چاپ‌کردن، یک نتیجه پس بدهند. این کار با کلمهٔ return (برگردان) انجام می‌شود:

def jam_kon(a, b):
    return a + b

natije = jam_kon(3, 4)
print(natije)

🖥️ چیزی که باید ببینی:

🤔 فرق print و return چیست؟ print فقط چیزی را نشانت می‌دهد (مثل آشپزی که غذا را از پشت شیشه نشانت بدهد). return نتیجه را تحویلت می‌دهد تا در جعبه‌ای بگذاری و بعداً استفاده‌اش کنی (مثل بیرون‌بر گرفتن!). در کد بالا، عدد ۷ تحویل داده شد و داخل جعبهٔ natije رفت.

📖 پاورقی ۷ — «تابع» (function) تکه‌کدی اسم‌دار که یک کار مشخص انجام می‌دهد و می‌شود بارها صدایش زد. print و len که قبلاً استفاده کردی هم تابع‌اند — فقط آماده‌ساختِ خودِ پایتون‌اند!

💡 نکتهٔ وایب کدینگ وقتی هوش مصنوعی یک برنامهٔ بلند برایت می‌نویسد، آن را به چند تابع تقسیم می‌کند. برای فهمیدن کد، اول فقط اسم تابع‌ها را بخوان — مثل فهرست کتاب! مثلاً اگر دیدی def download_file و def rename_photos، بدون خواندن جزئیات فهمیده‌ای برنامه چه‌کار می‌کند. بعد آخرِ کد را ببین که کدام تابع‌ها صدا زده می‌شوند و با چه ترتیبی.

✅ ایست بازرسی تابعِ jam_kon را با عددهای خودت صدا بزن: print(jam_kon(10, 20)) — باید ۳۰ ببینی.

کتابخانه‌ها و import 📚

مرحله ۱۰ از ۱۲⏱️ ~۴ دقیقه

لازم نیست همه‌چیز را از صفر بسازی! میلیون‌ها برنامه‌نویس، تابع‌های آماده‌شان را در بسته‌هایی به اسم کتابخانه^۸ گذاشته‌اند. با دستور import (وارد کن) یک کتابخانه را به برنامه‌ات می‌آوری — مثل قرض‌گرفتن یک جعبه‌ابزار کامل از همسایه:

import random

adad = random.randint(1, 6)
print(f"Tas: {adad}")

🖥️ چیزی که باید ببینی (عددش هر بار فرق می‌کند!):

Tas: 4

این کد یک تاس می‌اندازد! کتابخانهٔ random (تصادفی) را وارد کردیم و از تابعِ randint آن خواستیم یک عدد تصادفی بین ۱ تا ۶ بدهد. آن نقطه در random.randint یعنی «از داخلِ»: تابعِ randint از داخل جعبه‌ابزارِ random.

📖 پاورقی ۸ — «کتابخانه» (library یا module) مجموعه‌ای از تابع‌های آماده برای یک موضوع خاص. چندتا کتابخانه همراه خودِ پایتون می‌آید (مثل random برای شانس و datetime برای تاریخ و ساعت). هزاران کتابخانهٔ دیگر را هم می‌شود جداگانه نصب کرد — هوش مصنوعی هر وقت لازم باشد، خودش دستور نصبش را بهت می‌دهد.

💡 نکتهٔ وایب کدینگ خط‌های import همیشه بالای کد هستند. با خواندنشان می‌فهمی برنامه از چه ابزارهایی استفاده می‌کند: import os یعنی «با فایل‌ها و پوشه‌ها کار دارد»، import requests یعنی «به اینترنت وصل می‌شود». اگر موقع اجرا خطای ModuleNotFoundError دیدی، یعنی آن کتابخانه روی کامپیوترت نصب نیست — کافی است همین خطا را به هوش مصنوعی نشان بدهی تا دستور نصبش را بدهد.

✅ ایست بازرسی همان دو خط تاس را دوباره اجرا کن (در IDLE با فلشِ بالا یا تایپ دوباره). باید عدد جدیدی ببینی — چون تصادفی است!

۱۰

خطاها را بخوان، نترس! 🩹

مرحله ۱۱ از ۱۲⏱️ ~۵ دقیقه

مهارتِ شمارهٔ یکِ یک وایب‌کدر، نترسیدن از نوشته‌های قرمز است! خطا یعنی پایتون دارد مؤدبانه توضیح می‌دهد کجا گیر کرده — مثل معلمی که زیر غلط املایی‌ات خط می‌کشد و می‌گوید کدام کلمه اشتباه است. بیا عمداً یک خطا بسازیم. این را بنویس (عمداً غلط است!):

print(salam)

🖥️ چیزی که می‌بینی (قرمزرنگ):

Traceback (most recent call last): File "<pyshell#1>", line 1, in <module> print(salam) NameError: name 'salam' is not defined

ترسناک به نظر می‌رسد؟ فقط دو جایش را بخوان:

خط آخر — مهم‌ترین خط! نوع خطا و توضیحش: NameError: name 'salam' is not defined یعنی «خطای اسم: جعبه‌ای به اسم salam وجود ندارد.» راست هم می‌گوید — ما هیچ‌وقت جعبه‌ای به این اسم نساختیم و گیومه هم نگذاشتیم که متن حساب شود.

شمارهٔ خط — عبارتِ line 1 می‌گوید مشکل در خطِ چندمِ کد است، و خودِ خطِ خطادار را هم نشان می‌دهد.

معروف‌ترین خطاهایی که خواهی دید:

خطا	معنی به زبان ساده	معمولاً دلیلش
`SyntaxError`	«جمله‌ات از نظر دستور زبان غلط است»	دونقطهٔ جاافتاده، پرانتز یا گیومهٔ بسته‌نشده
`NameError`	«این اسم را نمی‌شناسم»	غلط تایپی در اسم متغیر/تابع، یا استفاده قبل از ساختن
`TypeError`	«این دو جنس با هم جور درنمی‌آیند»	جمع‌کردن متن با عدد، مثل `"5" + 3`
`IndentationError`	«تورفتگی‌ات به‌هم‌ریخته»	فاصلهٔ اول خط کم یا زیاد است
`IndexError`	«لیست این‌قدر عضو ندارد!»	مثلاً از لیستِ ۳تایی عضو شمارهٔ ۵ را خواسته‌ای
`ModuleNotFoundError`	«این کتابخانه نصب نیست»	باید کتابخانه را نصب کنی — از هوش مصنوعی بپرس چطور

💡 قانون طلایی وایب کدینگ هر وقت خطا دیدی، کلِ متن قرمز را کپی کن و عیناً برای هوش مصنوعی بفرست با این جمله: «این خطا را گرفتم، مشکل چیست و کد اصلاح‌شده را بده.» در ۹۰٪ موارد در همان پیام بعدی حل می‌شود. برای کپی‌کردن: با ماوس روی متن بکش تا رنگی شود، بعد کلیدهای Ctrl و C را با هم بزن.

✅ ایست بازرسی خودت یک خطا بساز: بنویس print("salam" (بدون پرانتز بسته) و Enter بزن. حالا بدون ترس بگو این چه نوع خطایی است. (جواب: SyntaxError — پرانتز بسته نشده!)

۱۱

وایب کدینگ عملی: اولین پروژهٔ واقعی‌ات 🤖🚀

مرحله ۱۲ از ۱۲⏱️ ~۱۰ دقیقه

حالا همهٔ آجرها را داری! وقتش است چرخهٔ کاملِ وایب کدینگ را یک بار واقعی انجام بدهی. اول یاد بگیریم کد را به‌جای پوسته، در یک فایل بنویسیم (برنامه‌های واقعی همیشه در فایل‌اند):

🗂️ الف) کدنویسی در فایل (به‌جای پوسته)

در پنجرهٔ IDLE، از منوی بالا روی File کلیک کن.

روی New File کلیک کن. یک پنجرهٔ سفیدِ خالی باز می‌شود — این «دفترچهٔ» برنامه‌ات است.

کدت را در این پنجره بنویس (یا کدِ هوش مصنوعی را در آن جای‌گذاری^۹ کن).

از منوی File گزینهٔ Save را بزن و یک اسم انگلیسی بده، مثلاً bazi.py (پسوندِ .py یعنی فایل پایتون).

برای اجرا: از منوی Run گزینهٔ Run Module را بزن (یا کلید F5). نتیجه در پنجرهٔ پوسته نمایش داده می‌شود.

📖 پاورقی ۹ — «جای‌گذاری» (Paste) یعنی چیزی که کپی کرده‌ای را بچسبانی: کلیک در جای مقصد، بعد کلیدهای Ctrl و V را با هم بزن.

💬 ب) چطور از هوش مصنوعی «درست» کد بخواهی؟

کیفیتِ کدی که می‌گیری به کیفیت درخواستت بستگی دارد. این ۴ قانون را رعایت کن:

قانون	❌ بد	✅ خوب
دقیق بگو چه می‌خواهی	«یه بازی بساز»	«یک بازی حدس عدد به پایتون بنویس: کامپیوتر عددی بین ۱ تا ۱۰۰ انتخاب کند و من حدس بزنم، و بگوید حدسم بزرگ‌تر است یا کوچک‌تر»
سطحت را بگو	(هیچی نگویی)	«مبتدی هستم؛ کد ساده بنویس و جلوی هر بخش کامنت توضیح بگذار»
محیطت را بگو	(هیچی نگویی)	«ویندوز دارم و با IDLE اجرا می‌کنم»
خطا را کامل برگردان	«کار نکرد!»	«این خطا را گرفتم: (کپیِ کامل متن قرمز)»

💡 «کامنت» چیست؟ در کد پایتون، هر خطی که با علامت # شروع شود، یادداشتِ توضیحی است و کامپیوتر آن را کاملاً نادیده می‌گیرد — فقط برای آدم‌هاست! وقتی از هوش مصنوعی می‌خواهی «با کامنت» بنویسد، یعنی کنار هر تکه کد، توضیحش را هم بنویسد. برای یادگیری معجزه می‌کند.

🎮 پ) حالا خودت انجامش بده — پروژهٔ پایانی

یک هوش مصنوعی (مثل Claude) را باز کن و این را بفرست: «یک بازی حدس عدد سادهٔ پایتون برای مبتدی بنویس، با کامنت فارسی برای هر خط.»

قبل از اجرا، کد را خط به خط بخوان و با دانشِ همین یک ساعت، حدس بزن هر خط چه‌کار می‌کند. حالا همه‌چیزش برایت آشناست: import random (تاس!)، while (تکرار تا وقتی...)، if/elif/else (تصمیم‌گیری)، int(...) (تبدیل متن به عدد).

هر خطی را که نفهمیدی، از هوش مصنوعی بپرس: «خط X یعنی چه؟ مثل بچه‌ها توضیح بده.» — این پرسیدن، خودِ یادگیری است!

کد را در یک New File جای‌گذاری کن، ذخیره کن و با F5 اجرا کن.

حالا یک تغییر بخواه! مثلاً: «کاری کن بازی تعداد حدس‌هایم را بشمارد و آخرش بگوید با چند حدس بردم.» کد جدید را بگیر، بخوان، اجرا کن. 🔁 این همان چرخهٔ وایب کدینگ است!

✅ ایست بازرسی نهایی اگر بازی اجرا شد و توانستی حداقل یک تغییر کوچک با کمک هوش مصنوعی در آن بدهی، رسماً وایب‌کدر شده‌ای! 🏆 اگر جایی گیر کردی، خطا را کپی کن و به هوش مصنوعی بده — یا بخش رفع اشکالِ پایین را ببین.

🔑 جدول رمزگشایی: هر علامتی در کد دیدی، این‌جا معنی‌اش هست

این جدول را مثل دیکشنری جیبی نگه دار. موقع خواندنِ هر کد پایتون، جواب «این علامت یعنی چه؟» این‌جاست:

علامت / کلمه	بخوانش:
`=`	«بگذار داخل جعبهٔ...»
`==`	«آیا برابر است با...؟»
`" "` یا `' '`	«این یک متن است»
`[ ]`	«لیست» (یا: عضو شمارهٔ فلان از لیست)
`{ }`	«دیکشنری» (دفترچهٔ کلید ← مقدار) یا جای خالی در f-string
`( )`	«ورودی‌های تابع» — چیزی که به دستور می‌دهیم
`:` در آخر خط	«حالا کارهای داخلش را می‌گویم...» (خط‌های بعدی تو می‌روند)
تورفتگی اول خط	«من داخلِ دستورِ بالایی هستم»
`#`	«یادداشت برای آدم‌ها — کامپیوتر رد می‌شود»
`if / elif / else`	«اگر / وگرنه اگر / وگرنه»
`for ... in ...`	«برای تک‌تکِ ... در ...»
`while`	«تا وقتی که ... تکرار کن»
`def`	«دستورپخت جدید تعریف می‌کنم»
`return`	«نتیجه را تحویل بده و برگرد»
`import`	«جعبه‌ابزار آماده را بیاور»
نقطه، مثل `random.randint`	«از داخلِ» — ابزارِ فلان از جعبه‌ابزارِ فلان
`input("...")`	«از کاربر سؤال بپرس و جوابش را بگیر» (جوابش همیشه متن است؛ برای عدد‌شدن دورش `int( )` می‌گذارند)

🔧

رفع اشکال‌های رایج

وقتی گیر کردی این‌جا بیا

مشکل ۱: IDLE در جست‌وجوی استارت پیدا نمی‌شود علت: احتمالاً نصبِ پایتون کامل نشده.
راه‌حل: فایل نصب را دوباره اجرا کن (اگر پرسید، Repair یا نصب دوباره را بزن) و صبر کن تا پیام successful را ببینی. بعد کامپیوتر را یک بار خاموش‌روشن کن و دوباره جست‌وجو کن.

مشکل ۲: نوشتم print(...) ولی خطای SyntaxError گرفتم علت: معمولاً یکی از این سه‌تا: حرف بزرگ نوشته‌ای (Print)، گیومه یا پرانتز را نبسته‌ای، یا به‌جای گیومهٔ انگلیسیِ " از گیومهٔ فارسیِ «» استفاده کرده‌ای.
راه‌حل: زبان کیبورد را با کلیدهای Alt+Shift (یا Win+Space) روی انگلیسی بگذار و خط را دوباره، دقیقاً مثل نمونه، تایپ کن.

مشکل ۳: خطای NameError می‌گیرم علت: از جعبه‌ای استفاده کرده‌ای که هنوز نساخته‌ای، یا اسمش را غلط تایپ کرده‌ای (nam به‌جای name). حواست باشد: اگر پوستهٔ IDLE را ببندی، همهٔ جعبه‌ها پاک می‌شوند و باید از اول بسازی‌شان!
راه‌حل: اول خطِ ساختِ متغیر را اجرا کن (مثلاً name = "Sara")، بعد استفاده‌اش کن. املا را حرف‌به‌حرف چک کن.

مشکل ۴: خطای IndentationError یا رفتار عجیب بعد از if و for علت: تورفتگیِ خط‌های داخلی درست نیست.
راه‌حل: بعد از خطی که به دونقطه ختم می‌شود، خطِ بعدی را دقیقاً با ۴ فاصله (یا یک بار کلید Tab) شروع کن. همهٔ خط‌های داخلِ یک بلوک باید تورفتگیِ یکسان داشته باشند. در پوسته، برای تمام‌کردن بلوک و اجرای آن، یک Enter اضافه روی خط خالی بزن.

مشکل ۵: تایپ فارسی در کد، همه‌چیز را به‌هم می‌ریزد علت: دستورهای پایتون باید انگلیسی باشند؛ حروف فارسی در اسم دستورها جواب نمی‌دهد.
راه‌حل: کد را انگلیسی بنویس. متن فارسی فقط داخل گیومه‌ها مجاز است، مثلاً print("سلام") کاملاً درست کار می‌کند.

مشکل ۶: کدِ هوش مصنوعی را اجرا کردم، خطای ModuleNotFoundError گرفتم علت: کد از کتابخانه‌ای استفاده می‌کند که روی کامپیوترت نصب نیست.
راه‌حل: متن کامل خطا را کپی کن و به هوش مصنوعی بگو: «این خطا را گرفتم، روی ویندوز چطور نصبش کنم؟ قدم‌به‌قدم بگو.» او دستور نصب را می‌دهد (معمولاً چیزی شبیه pip install ... که در ابزاری به اسم Command Prompt تایپ می‌شود — هوش مصنوعی راهنمایی‌ات می‌کند).

مشکل ۷: کد اجرا می‌شود ولی کاری که می‌خواستم را نمی‌کند علت: این خطا نیست، «سوءتفاهم» است! برنامه دقیقاً همان چیزی را انجام داده که نوشته شده — فقط چیزی که نوشته شده با چیزی که در ذهنِ تو بود فرق دارد.
راه‌حل: به هوش مصنوعی بگو: «کد اجرا شد ولی انتظار داشتم X شود، در عوض Y شد.» هر چه دقیق‌تر تفاوت را بگویی، سریع‌تر درست می‌شود. این حرفه‌ای‌ترین جملهٔ وایب کدینگ است!

🎉 تمام شد! حالا تو بلدی...

✅ پایتون نصب کنی و کد را در IDLE (پوسته و فایل) اجرا کنی
✅ متغیرها (جعبه‌ها)، عدد و متن و بولی را از هم تشخیص بدهی
✅ لیست [ ] و دیکشنری { } را بخوانی
✅ شرط‌ها (if)، حلقه‌ها (for) و تابع‌ها (def) را بفهمی
✅ خطاها را بدون ترس بخوانی و برای هوش مصنوعی بفرستی
✅ چرخهٔ وایب کدینگ را بچرخانی: بخواه ← بخوان ← اجرا کن ← اصلاح کن 🔁

قدم بعدی؟ همین امشب یک پروژهٔ کوچکِ به‌دردبخور از هوش مصنوعی بخواه — مثلاً «برنامه‌ای که تولد دوستانم را یادآوری کند» — و چرخه را بچرخان. هر پروژه، ده برابرِ هر آموزشی یادت می‌دهد. 🚀