1. 環(huán)境配置：“在我電腦上是好的！”
抓狂點(diǎn)：環(huán)境不一致導(dǎo)致代碼行為詭異。
應(yīng)對方法：
容器化：使用 Docker 和 Docker Compose。將環(huán)境（操作系統(tǒng)、依賴、配置）代碼化，確保每個(gè)人在任何機(jī)器上啟動(dòng)的都是完全一致的環(huán)境。這是終極解決方案。
配置即代碼：使用 Ansible, Chef, Puppet 等工具自動(dòng)化環(huán)境配置。
版本化依賴：嚴(yán)格使用 package-lock.json, Pipfile.lock, Gemfile.lock 等鎖文件，確保依賴樹一致。
完善的 README：項(xiàng)目根目錄必須有一個(gè)清晰、及時(shí)更新的 README.md，詳細(xì)說明環(huán)境 setup 步驟。
2. 依賴地獄（Dependency Hell）
抓狂點(diǎn)：版本沖突，依賴無法安裝。
應(yīng)對方法：
信任鎖文件：永遠(yuǎn)將鎖文件提交到版本控制，不要手動(dòng)運(yùn)行 npm update 之類的命令來“碰運(yùn)氣”。
定期更新：設(shè)立周期（如每月），有計(jì)劃地更新依賴，而不是等到積重難返。
使用虛擬環(huán)境：Python 的 venv，Node.js 的 nvm，Ruby 的 rvm/rbenv 可以隔離不同項(xiàng)目的依賴。
審查依賴：使用 npm audit，snyk 等工具定期檢查安全漏洞，并評估是否真的需要引入某個(gè)龐大的庫。
3. 神秘莫測的報(bào)錯(cuò)信息
抓狂點(diǎn)：錯(cuò)誤信息不直觀，無從下手。
應(yīng)對方法：
修煉搜索大法：將錯(cuò)誤信息的關(guān)鍵部分（去除項(xiàng)目特有的路徑和變量）復(fù)制到 Google/Stack Overflow 搜索。你遇到的路，前人基本都走過。增加日志：在關(guān)鍵函數(shù)入口、出口和判斷點(diǎn)添加清晰的日志（console.log, print, logger.info），讓程序運(yùn)行軌跡可視化。
使用調(diào)試器：熟練掌握 IDE 的調(diào)試器（斷點(diǎn)、單步執(zhí)行、查看變量），這是定位問題最強(qiáng)大的武器。
二分法排查：對于大段代碼，使用“注釋掉一半”的方法，快速定位問題范圍。
4. 代碼風(fēng)格/規(guī)范之爭
抓狂點(diǎn)：無休止的格式爭論。
應(yīng)對方法：
自動(dòng)化格式化：使用 Prettier, Black, Gofmt, ESLint 等工具，在保存或提交時(shí)自動(dòng)格式化代碼。沒有爭論，機(jī)器說了算。
制定團(tuán)隊(duì)規(guī)范：在項(xiàng)目初期就約定好規(guī)范，并寫入配置文件（如 .eslintrc, .editorconfig），讓工具來約束。
CR聚焦邏輯：在代碼審查中，大家約定俗成，對于格式問題由工具保證，重點(diǎn)審查代碼設(shè)計(jì)、邏輯和潛在bug。
5. 薛定諤的Bug（Heisenbug/Bohrbug）
抓狂點(diǎn)：Bug難以穩(wěn)定復(fù)現(xiàn)。
應(yīng)對方法：
詳盡的日志：這是最重要的手段。增加日志級別，在可疑區(qū)域輸出更詳細(xì)的狀態(tài)信息。
錄制和回放：對于前端Bug，使用瀏覽器插件錄制操作序列；對于后端，嘗試錄制流量進(jìn)行回放。
單元測試：為復(fù)現(xiàn)的Bug先寫一個(gè)失敗的單元測試，然后修復(fù)代碼讓測試通過。這既能修復(fù)Bug，也能防止未來回歸。
心態(tài)放平：承認(rèn)有些Bug就是“玄學(xué)”，暫時(shí)擱置，也許在解決其他問題時(shí)它會自己暴露出來。
6. 寫文檔和注釋
抓狂點(diǎn)：抗拒、拖延，事后看不懂自己的代碼。
應(yīng)對方法：
“剛好夠用”的文檔：不追求大而全，但保證API文檔、架構(gòu)設(shè)計(jì)圖、部署流程是清晰和最新的。
代碼即文檔：起一個(gè)好理解的函數(shù)名和變量名，比任何注釋都強(qiáng)。注釋應(yīng)該解釋“為什么這么做”（背后的意圖或坑），而不是“做了什么”（代碼已經(jīng)表達(dá)了）。
將文檔作為CR的一部分：將文檔的更新作為代碼合并的前提條件。
使用工具：Swagger/OpenAPI 用于API文檔，JSDoc/Doxygen 用于生成代碼文檔。
