探討為什麼不應在示例程式碼中使用 TODO 佔位註釋

2026 年 11 月 5 日，DEV Community 的 AI 版塊發表了一篇題為《探討為什麼不應在示例程式碼中使用 TODO 佔位註釋》的文章。文章指出，教程示例程式碼中的 TODO 佔位註釋會讓開發者在複製使用時報立刻報錯，尤其當不清楚需要填寫什麼內容時，這種體驗令人沮喪。文中給出的例子是 `# TODO(developer): Uncomment and set your instance` 與 `instance_id = "your-instance-id"` 這樣的佔位內容，隨後呼叫 `client = storage.Client(instance_id)`。

文章將這種寫法稱為 copy-paste-completable 模式，即作者寫示例時本能地先留出佔位符。隨著 AI 助手和自動化 Agent 越來越普遍，這些佔位符會被 AI 直接複製進生成的程式碼中，進一步放大問題。文章的建議是改用直接可執行或帶安全預設值的寫法。這是該事件目前唯一的報道，後續進展暫無公開資訊。