Charles Lee

2025-01-12 清潔程式碼/日誌/註釋/出遊

  • 撰写语言: 韓国語
  • 基准国家: 所有国家country-flag
  • 信息技术

撰写: 2025-01-13

撰写: 2025-01-13 00:16

看看世界。

經濟

出遊

  • 富平站地下街 (因拜訪熟人而首次造訪):人山人海,很難靜靜地站著。規模很大,物價也很便宜,很棒。
2025-01-12 清潔程式碼/日誌/註釋/出遊

IT

英文學習

  • 事先準備好英文,並使用 ChatGPT 提問,以獲得滿意的答案。看來英文老師的工作機會將減少,而對於自己的寫作幫助很大。我每天都會閱讀文章並進行摘要,然後向 ChatGPT 詢問以確認更好的句子。
    • 請更正以下英文錯誤,並將錯誤部分單獨標示出來。請以 Markdown 格式回覆。請勿留空行。

程式碼

  • 最好使用什麼來記錄日誌?我搜尋了開源項目,並撰寫了關於在 Python 和 Bash 中使用日誌記錄器的內容。Python 有內建的標準模組 logger,但我認為功能更豐富的 loguru 更好,並且如果能一起顯示類別名稱會更好,所以我新增了測試內容。對於 Bash,我也認為需要 info/warn/critical 等區分,因此處理了相關的開源項目: https://github.com/cheoljoo/publish/blob/main/log.md
  • 盡可能像乾淨程式碼中所述的那樣,使程式碼易於閱讀,從而減少對註釋的需求。但是,在 Python 中,最好在類別/函式級別使用 docstring 形式的註釋。這是因為可以自動生成文檔。對於 Bash,如果像 docstring 一樣用 # 進行註釋,則也可以建立必要的工具來自動生成文檔: https://github.com/cheoljoo/publish/blob/main/comments.md
    • 在 Bash 中,需要注意的是所有變數都是全域變數,因此如果在註釋中清楚地說明這一點,則可以建立一個使用映射的工具,以一目瞭然地瞭解變數在何處使用。(如有好的想法,請提出建議。)

评论0