TypeScript 程式碼審查程式設計教學

TypeScript 程式碼審查:型別、結構與錯誤

通常 15 分鐘內完成含修改次數品質檢查
方案
付款保障詳細資訊
  • 方案內的修改免費。
  • 若您在交付後 3 天內未回應,成果將自動驗收。

付款時款項會先保留,在您驗收後才會撥付。

TypeScript 程式碼審查:型別、結構與錯誤

成果範例

標準版方案範例

Code review: Python order-import script for a small online shop

What the code does

  1. Reads orders.csv from the shop export.
  2. For each order line, finds the product by SKU in stock.xlsx and subtracts the quantity.
  3. Writes the updated stock back and logs totals to import_log.txt.

The structure is clear and functions are well named. Most issues are about input that does not look the way the script expects.

Bugs and weak spots

#LineSeverityIssue
148HighThe same CSV can be imported twice; there is no check for already processed order IDs. This is the most likely cause of negative stock.
272Highint(row["qty"]) crashes on empty or "2.0" values from refunded orders.
395MediumSKU lookup is case-sensitive: "gt-101" and "GT-101" are treated as different products.
4130MediumThe file is opened without encoding="utf-8", so product names with accents break on Windows.
5201LowBare except: hides real errors and makes the log useless.

Corrected fragments

Issue 1: skip orders already imported

processed = load_processed_ids("processed_orders.txt")
for row in reader:
    if row["order_id"] in processed:
        continue
    # ... existing logic ...
    processed.add(row["order_id"])
save_processed_ids("processed_orders.txt", processed)

Why: each order is applied once, even if you run the script on the same file again.

Issue 2: read quantity safely

raw = (row.get("qty") or "").strip()
try:
    qty = int(float(raw))
except ValueError:
    log.warning("Order %s: bad quantity %r, skipped", row["order_id"], raw)
    continue

Why: refunded or partial lines are skipped with a clear note instead of stopping the whole import.

Issue 3: normalise SKUs

sku = row["sku"].strip().upper()

Apply the same .strip().upper() when building the stock dictionary.

Style and readability

  • process() is 90 lines long; split it into read_orders, apply_to_stock, write_report.
  • Replace magic column numbers (row[7]) with header names.

Please test each fix on a copy of your files: we read the code but did not run it.

Client: owner of a tea shop who wrote a 310-line Python script that imports orders from a CSV export into the stock spreadsheet Problem reported: "Sometimes stock goes negative, and the script crashes on some files."

客戶與所有細節皆為虛構。

關於此服務

只有當型別真實反映程式碼的行為時,TypeScript 才能保護您;許多專案卻慢慢充斥著 any、未經檢查的型別斷言,以及從來不是真正選填的選填欄位。我們會閱讀您的程式碼與型別定義,說明讓您卡關的編譯器錯誤,並展示在哪些地方可以用型別縮小、聯合型別或小型泛型取代強制轉型。修正片段考量嚴格模式,因此編譯器日後更嚴格時,修正依然有效。

包含內容

  • 您會收到什麼在訂單頁面提供的書面審查:編譯器錯誤的解讀、依風險列出的薄弱型別,以及附更完善型別定義的修正片段。進階版另附逐步啟用更嚴格編譯器選項的計畫。
  • 編譯器錯誤解讀把冗長的訊息變成淺白的文字
  • 減少 any 與強制轉型以更安全的型別取代
  • 型別縮小與聯合型別讓編譯器檢查各分支
  • 介面與泛型可重複使用且易讀的型別定義
  • 修正片段每項變更都附說明

服務流程

  1. 1
    需求說明您貼上程式碼、型別與錯誤
  2. 2
    閱讀我們對照實際行為檢查型別
  3. 3
    審查您會收到說明與更完善的型別

需要您提供的資料

以文字或截圖貼上的 TypeScript 程式碼與型別、您的 tsconfig 設定、TypeScript 版本,以及完整的編譯器錯誤訊息。

我們會詢問您:

  • 您使用哪個 TypeScript 版本與框架?
  • 有啟用嚴格模式嗎?
  • 哪些編譯器錯誤或型別問題讓您卡關?
  • 您是要把 JavaScript 專案遷移到 TypeScript 嗎?

比較方案

方案基本版100 行內程式碼US$15標準版400 行內程式碼US$35進階版1,000 行內並附嚴格性計畫US$69
交付期限1 天2 天3 天
修改次數123
程式碼行數最多 100 行最多 400 行最多 1,000 行
修正片段有有有
嚴格性計畫無無有
訂購 基本版訂購 標準版訂購 進階版

付款保障

下單時付款,但只有在驗收成果後,款項才會撥付。

  • 固定價格付款後,方案價格不會變動。
  • 款項先行保留付款時,金額只會先保留,在您驗收後才會撥付給服務。
  • 交付前檢查每份成果在交到您手上之前都會經過品質檢查,您也可以在驗收前於訂單頁面查看成果。
  • 免費修改在需求說明範圍內,可依方案允許的次數提出修改。
  • 3 天後自動驗收若您在交付後 3 天內未驗收也未提出修改,成果將自動驗收。若您在交付後於訂單聊天室留言,訂單會暫停自動驗收;我們回覆後,可能會重新起算 3 天,並會在聊天室中告知。
  • 重新製作或全額退款若成果不符合您的需求說明且修改後仍未改善,或製作時間超過交付期限的兩倍,請在訂單聊天室留言:我們將重新製作,或全額退還款項。
運作方式 →

常見問題

你們會執行我的程式碼嗎?

不會。我們會仔細閱讀並推論其行為,但不會執行,因此請在您自己的專案中測試每個建議的修正。

你們可以直接告訴我怎麼讓錯誤消失嗎?

可以,但我們會先說明這個錯誤在保護您免於什麼問題,並在有解法時提供有型別的修正。

你們能協助從 JavaScript 遷移嗎?

可以。請貼上您要轉換的檔案,我們會建議型別以及轉換的順序。

沒有找到您要的答案?

方案