歡迎來到 PyTorch 貢獻(xiàn)指南！無論你是編程新手還是有經(jīng)驗的開發(fā)者，都可以通過貢獻(xiàn)代碼、文檔、教程等方式參與 PyTorch 開源項目。這份指南將帶你一步步了解如何為 PyTorch 做貢獻(xiàn)。

一、PyTorch 貢獻(xiàn)基本流程

（一）確定貢獻(xiàn)內(nèi)容

• 找到感興趣的任務(wù) ：如果你不確定要做什么，可以瀏覽 PyTorch 的問題跟蹤器，看看有沒有你可以解決的問題。標(biāo)有 “訓(xùn)練營” 和 “1 小時” 標(biāo)簽的問題通常比較適合新手。
• 提出新想法 ：如果你有新的功能想法，可以在 PyTorch 的討論論壇發(fā)帖，詳細(xì)介紹你的想法、相關(guān)數(shù)據(jù)和解決方案。

（二）進(jìn)行開發(fā)

• 小幅度更改直接開發(fā) ：如果變更幅度較小，你可以直接開始編碼。
• 大幅度更改先討論 ：如果變更范圍較大，建議先在 GitHub 問題中提交設(shè)計討論，等待反饋后再進(jìn)行開發(fā)。

（三）提交拉取請求（PR）

• 標(biāo)記未完成的 PR ：如果你的 PR 還未完成，可以在標(biāo)題前加上 “[WIP]”，表示這是一個草稿版的 PR。
• 找到合適的審閱者 ：你可以將 PR 發(fā)送給相關(guān)的子系統(tǒng)維護(hù)者，讓他們進(jìn)行審閱。

（四）根據(jù)反饋迭代 PR

• 減少審核往返次數(shù) ：PyTorch 團(tuán)隊會盡量減少審核的來回次數(shù)，只在出現(xiàn)重大問題時才阻止 PR。
• PR 通過后合并 ：一旦 PR 被接受且 CI（持續(xù)集成）通過，PyTorch 團(tuán)隊會將其合并。

二、適合新手的貢獻(xiàn)方式

（一）報告問題

• 查找現(xiàn)有問題 ：在報告新問題之前，先搜索一下 PyTorch 的問題庫，看看是否已經(jīng)有類似的問題。
• 詳細(xì)描述問題 ：創(chuàng)建新問題時，要盡可能詳細(xì)地描述問題的表現(xiàn)、你的預(yù)期行為以及如何重現(xiàn)該問題。

（二）修復(fù)簡單問題

• 從簡單標(biāo)簽入手 ：標(biāo)有 “新發(fā)行”“低” 或 “中” 優(yōu)先級的問題是新手的好起點。
• 與團(tuán)隊溝通 ：在解決問題之前，先在問題下發(fā)表評論，說明你的意圖，并與 PyTorch 團(tuán)隊討論解決方案。

（三）改進(jìn)文檔和教程

• 修正文檔錯誤 ：如果你發(fā)現(xiàn)文檔中有錯別字或錯誤，可以直接提交 PR 進(jìn)行修正。
• 撰寫新教程 ：你可以根據(jù)自己的經(jīng)驗和理解，撰寫新的 PyTorch 教程，分享給社區(qū)。

三、貢獻(xiàn)過程中的注意事項

（一）代碼規(guī)范

• 添加測試 ：對于大多數(shù)變更，都需要添加相應(yīng)的測試，以確保代碼的正確性和穩(wěn)定性。
• 保持代碼風(fēng)格一致 ：盡量遵循 PyTorch 項目現(xiàn)有的代碼風(fēng)格，使代碼更具可讀性。

（二）PR 規(guī)范

• 保持 PR 簡潔 ：盡量將變更范圍控制在較小的范圍內(nèi)，避免提交過大的 PR。
• 清晰描述 PR 內(nèi)容 ：在 PR 描述中，清楚地說明你的變更內(nèi)容和目的，方便審閱者理解。

（三）溝通規(guī)范

• 積極參與討論 ：在 PyTorch 的討論論壇和問題跟蹤器中，積極參與討論，與其他貢獻(xiàn)者和團(tuán)隊成員交流想法。
• 及時反饋 ：如果你在貢獻(xiàn)過程中遇到問題，及時在相關(guān)渠道反饋，尋求幫助。

四、開源社區(qū)文化

（一）無 “聲稱” 問題

在開源社區(qū)，通常無法 “聲稱” 一個問題。這意味著你可以隨時開始處理一個問題，但也要接受其他人可能也在處理同一個問題的事實。

（二）新功能的高標(biāo)準(zhǔn)

由于開源項目維護(hù)者需要對所有合并的代碼負(fù)責(zé)，因此新功能的貢獻(xiàn)標(biāo)準(zhǔn)相對較高。在提交新功能之前，確保它具有實際價值，并且得到了社區(qū)的廣泛認(rèn)可。

五、常見問題解答

（一）如何成為審稿人

你可以通過積極參與社區(qū)活動、提交高質(zhì)量的 PR 等方式，逐漸建立自己的聲譽(yù)，從而有機(jī)會成為審稿人。

（二）CI 測試失敗怎么辦

如果 CI 測試失敗，可以嘗試重新基于最新的 main 分支進(jìn)行開發(fā)，或者查看錯誤信息并解決問題。

（三）什么是高風(fēng)險變更

涉及構(gòu)建配置的變更通常被認(rèn)為是高風(fēng)險的，因為在這些地方的錯誤可能導(dǎo)致整個項目的構(gòu)建失敗。

六、總結(jié)

恭喜你！現(xiàn)在你已經(jīng)對 PyTorch 開源貢獻(xiàn)的流程和規(guī)范有了基本的了解。貢獻(xiàn)開源項目不僅可以提升你的編程技能，還可以讓你與其他開發(fā)者交流經(jīng)驗，共同進(jìn)步。編程獅也鼓勵大家積極參與開源社區(qū)，為推動技術(shù)發(fā)展貢獻(xiàn)自己的力量。如果你在貢獻(xiàn)過程中有任何問題，可以在 W3Cschool 社區(qū)尋求幫助。