104學習精靈

一零四獨家新知識

nabi總知識長

2023/09/11

Python 註解:單行註解請使用#,多行註解請使用以下這個

當我們談到程式編碼時,除了主要的程式碼邏輯外,註解也扮演著一個不可或缺的角色。註解不只幫助開發者更好地理解和記錄程式碼的功能和目的,還能確保團隊合作時的順暢性。在本文中,我們將探討 Python 中註解的使用方法和它的重要性。
① 什麼是註解?
註解是在程式碼中加入的文字說明,主要用來描述程式碼的功能或解釋特定的程式段落。重要的是,註解不會被解譯器執行,所以它不會影響程式的運行結果。
② Python中的註解方法
單行註解:
在 Python 中,使用 # 符號來撰寫單行註解。
python
Copy code
# 這是一個單行註解
print("Hello, World!")
多行註解:
雖然 Python 沒有專門的多行註解符號,但常見的做法是使用三引號(單引號或雙引號都可以)來撰寫多行註解。
python
Copy code
'''
這是多行註解的
第一行
第二行
'''
print("Hello, World!")
或者
python
Copy code
"""
這也是多行註解的
第一行
第二行
"""
print("Hello, World!")
③ 註解的重要性
✅ 增加可讀性:對於那些不熟悉你程式碼的人,註解能夠幫助他們更快地理解程式碼的功能和邏輯。
✅ 為修改提供背景:在未來需要修改或維護程式碼時,註解可以提供原始的思考過程和背景資訊,使修改更為順暢。
✅ 方便團隊合作:在團隊開發中,註解可以確保所有成員對程式碼的理解都在同一頁上,減少誤解和錯誤。
④ 好的註解習慣
✅ 簡潔明確:註解應該簡短且直接到點,避免冗長和不必要的描述。
✅ 避免明顯註解:例如 x = x + 1 # 增加x的值,這種註解是多餘的,因為程式碼本身已經很清楚。
✅ 定期更新:當程式碼更新時,相關的註解也應該被更新以保持一致性。
在 Python 或任何程式語言中,註解都是極其重要的。透過使用恰當和有意義的註解,我們可以確保程式碼的可讀性和可維護性,並在團隊合作中提高效率。
1 0 21353 1

0/1000

你可能會想看
01
林閔政 ・就業服務講師・05/07 09:00
【AI認證:我竟然是某個記憶法的代表人物?!】
之後要跟一群來自不同國家的學生,分享我一路「靠想像力硬撐過來」的記憶法課程。 在準備簡報時,我突發奇想,問問AI:「有什麼記憶術主題適合外國人?」 結果,它居然推薦了——彩虹記憶法 🌈 我愣住了。這不是我五年前寫《就業服務乙級超神記憶攻略》時,自己創的名詞嗎? 當時 Google 搜尋還完全找不到這個詞,連出版社都說這是「#獨創」才敢印在書封上。 今天再一查,「彩虹記憶法」居然真的成了一個詞。 更意外的是:林閔政=這個詞的代表人物之一。 我是中高齡才開始重考證照的人, 讀10分鐘忘9分鐘,每次都很焦慮。 我知道什麼叫「想背卻背不起來」,也知道「讀懂了但考題完全不一樣」的挫折。 所以,我發明了: ☑️ 彩虹記憶法|讓抽象的東西,變成有顏色、有畫面的記憶。 ☑️ 拆字記憶法|把陌生法條詞拆開,一筆一劃都看進去。 ☑️ 三角關係思考法|學會怎麼把「你知道的」連結到「你要記住的」。 不是因為我特別會記憶,而是因為我特別容易忘記。 所以我只能不斷地想辦法,讓自己記得久一點、多一點、準一點。 沒想到,當年我因為記憶力不行、只能土法煉鋼硬撐出來的技巧, 今天竟然變成了 AI認可的「記憶方法」之一, 還說我是代表人物。這世界真的很神奇。 也許,這是一段更大冒險的開始。 也許,昨天怕記不住的我,今天終於記得了—— 這一路,我從來沒放棄。 【我只是怕忘記,但竟然記住了人生的另一種可能】 最初,我只是怕自己記不住。 怕錯過那個法條細節、怕寫不出申論、怕考場上的自己突然一片空白。 我開始用顏色、畫面、聯想,去「抓住記憶」這件事。 原本只是自救,沒想到…慢慢地,它們變成了一套方法、一堂課,甚至現在,變成了某些人嘴裡的:「老師,你教的那個彩虹記憶法好用耶!」 🌈 我不是記憶力好的人,但我是一個不想被記憶力打敗的人。 我不是一開始就會的人, 我是一步一步,把困難拆小,把陌生變熟的人。 也許你現在正在懷疑: 「我是不是記不住?」「我是不是學不會?」「是不是我比較笨?」 但你要知道——會記得的人,不是最聰明的那一個,而是最願意練習、願意試錯的那一個。 ♥ 記憶的起點,從來不是『我記得了』,而是『我願意記住』。 ♥ 每一段你以為白費的努力,都是你大腦在說:「我還在走,不要放棄我。」 #彩虹記憶法 #拆字記憶法 #三角關係思考法 #中高齡學習力 #這條路我不孤單 #AI認證我沒想過的事 #職涯不設限 #就業服務乙級 #從學不會的人變成會教別人的人
1 0 1378 0
02
林閔政 ・就業服務講師・05/05 09:09
正在為你鋪好這條直路|就業服務乙級課程說明
▌♥ 走過波折的我,正在為你鋪好這條直路|就業服務乙級課程說明 很多同學問我: 「老師,線上的就業服務乙級課程,到底該怎麼選?」 沒關係,這裡我一次說清楚,目前我們有 5種課程方案,讓你依照時間和需求自由搭配: 📘 一日總複習實體班|適合已經準備過一輪,只差臨門一腳的你。 📘 100天全方位解讀班|適合還有一點時間,想完整學會法規邏輯與考題應對的人。 📘 220天全套精讀班|給想從零開始、一步步建立觀念與信心的你。 (※📌100天與220天內容完全相同,差別只有觀看期限) 📘 100天全方位解讀班|加實體總複習,雙學習模式補全最後一哩路。 📘 30天線上總複習|加實體總複習,已有一定基礎觀念缺少面對考試的信心。 ▌♥「法條更新了沒?」這個問題,我很在意。 我只能說:沒更新,我自己都過意不去! 每當法條修正,我就會馬上停下手邊工作,回頭補拍補改。 我不是天才型考生, 一路從報社記者、電視台編輯、新聞剪接、攝影、主持人…… 我不是考證照的模範生,卻是那個用錯誤換來經驗、從撞牆中找到破解法的人。 也因此,我知道你們為什麼會卡關—— 很多法律書寫得「每個字都懂、但整句都看不懂」。 因為高材生寫書時,根本沒想過我們這些「繞過遠路」的人,怎麼學習。 ▌♥ 如果你也是這樣的你—— 不是天選之人、不是讀一遍就懂的人、不是一戰成名的考神。 而是會懷疑、會迷路、會焦慮、但還願意撐下去的人—— 那我會說,我懂你。 而我的課,可能正是為你這樣的人設計的。 請你相信, 你不是慢、不是差,而是走得比較用心。 我們的每一次失敗,其實都在訓練我們成為更有感覺的學習者。 📌 點這裡看課程資訊與報名方式 👉https://23dreamhome.vip/courses 📩 也可以加入 LINE 官方帳號來私訊詢問:https://lin.ee/oPSy2awE
0 0 809 0
正在為你鋪好這條直路|就業服務乙級課程說明
04
蘇宏文 知識長 ・集團法務長・04/29 08:00
看案例得啟發系列_雇主與勞工約定每月工資採統包制,可行嗎?
本系列將以我國司法實務或勞工行政主管機關裁罰事業單位違章案例或其他勞動法訴訟案例為整理編輯對象,提供讀者經由解讀個案的事實及理由,得到啟發,並以之作為自家公司法律遵循的參考。 以臺灣高雄地方法院111年度勞訴字第107號民事判決為例(為方便閱讀,內文有編修): 被告答辯: 原告於102年3月受僱被告,約莫3個月即離職,年資已中斷。嗣於105年5月左右再受僱訴外人即被告之子施君經營之○○果汁中山店(位於高雄市○○區○○路○○號),至111年5月18日原告發函終止勞動關係而離職,雙方並無僱傭關係。縱令存在僱傭關係,原告受僱期間中午均有休息1小時,雙方已經約定所給付者包括各項加班費、特休薪資、退休金提撥及保險補貼(下稱統包制)。依照雙方統包制之約定,顯然優於勞基法規定,原告即應受此拘束,原告起訴顯然違反誠信原則。 判決理由: 依照勞基法第23條第1項,工資之給付應提供工資各項目計算方式明細。且雇主應將勞工每年特別休假之期日及未休之日數所發給之工資數額,記載於同法第23條所定之勞工工資清冊,並每年定期將其內容以書面通知勞工,同法第38條第4項亦有明文。因此雇主與勞工為便利計算薪酬,就應給付勞工含加班費、特別休假未休工資等工資項目,雖非不得採取一定額度給付(常稱為統包制),但仍須可明確區分何者為平日工資,何者為加班費,以判斷延長工時、特別休假未休工資之給與,是否合於法律規定之標準。如僅泛稱統包制,未能符合上開規定,也無工資清冊或書面詳載統包之範圍及各項目,即已欠缺法律所規定之方式,自不因此而得免於給付工資之義務。 經查,被告主張雙方就薪資有約定統包制,但為原告所否認。被告雖以○○之證詞為佐,惟查,薪資乃屬個人事項,本得由雇主與勞工間個別為不同約定,證人○○與被告如何約定,與原告無必然關聯,不能以此證明雙方間就薪資有約定統包制。且雙方不爭執施君每月發薪時,均有與原告核對出勤、借支及薪資内容,並均經原告於攷勤表上簽名確認領收無訛。以被告發薪尚且逐筆核對且要求原告簽名,若有統包制之約定,又豈會毫無書面?且攷勤表上還有多筆給付雙方對於名目始終有所爭執,僅是透過簡化爭點轉換為加班費之扣項,根本無從明確區分所稱統包範圍為何。被告辯稱統包制,實難採信。縱使有統包制之約定,仍應能區分何者為平日工資、何者為加班費,並就統包範圍詳為約定。然被告於本件並無提出工資清冊,且記載於攷勤表上之各項數字並無記載名目以及計算方式,更無統包制相關文義之記載。依前揭說明,仍不免其給付工資之義務,被告仍應依法給付加班費、特休未休工資以及提繳勞工退休金。
0 0 600 0
一零四資訊科技股份有限公司 版權所有 © 2025 建議瀏覽器 Chrome / IE11.0 以上