Vue.js 官方中文文檔寫的很爛嗎？

01-11

為什麼我閱讀中文文檔感覺很吃力？很多地方語法不通順？

Vue 的中文文檔是在英文版基礎上由社區貢獻翻譯的，我覺得你說的情況（比如語句不通順等等）還是有可能存在的。不妨把你覺得讀不通的地方找出來，去翻譯項目的 repo發 issue/PR。你這個提問的方式，說實話很糟糕。

PS. 我覺得大家也不要一味噴題主吧，翻譯的問題還是有一些的，我就提過 PR。你們看看已經關閉的 PR就知道，翻譯項目一直在修復和優化中，絕非完美。

同意 @顧軼靈的觀點：

不妨把你覺得讀不通的地方找出來，去翻譯項目的 repo發 issue/PR

項目需要不斷迭代，羅馬並不是一天建成的。

開源意味著你可以獲得項目所有的細節，也可以參與改進所有的細節。

以其做旁觀者，不如做參與者。

當然安安靜靜做個旁觀者也好。

不要挖苦諷刺潑髒水、指點江山又一輪。

具體哪些地方讀不通，指出來，反饋給項目組，幫助項目繼續改進。

知道開源社區嗎？

開源社區的意思就是如果你覺得 Vue 的文檔爛，你可以動手改，改完之後會有人感謝你的。

我恰好這一段在寫Spring MVC和Vue，由於之前沒接觸過Vue，所以是首選過一遍Vue官方教程，至今沒發現什麼不太順的地兒。相反，我感覺例子豐富，語言描述不冗餘，看著非常適應自己思路。

我覺得如果有覺得不通順之處，可以列舉一二，讓大伙兒都看看。一方面習慣問題因人而異，有可能別人習慣的風格自個兒不一定習慣，另一方面如果確實有大伙兒都認為的不通順之處，也能幫助Vue團隊改進與提高。

此外，其他人也提到了，可以一起為Vue的文檔做貢獻，或反饋問題給Vue團隊，這都是很好的開源協作方式。

可能題主也只想大致提一下而已，但如果能舉例若干，則更能讓大伙兒信服。如果只是一句話甩出來然後就沒有具體下文或焦點，可能就讓人誤以為是「鍵盤俠」。

Vue.js 中文文檔 - Vuefe

不可否認，官方文檔翻譯人員眾多，翻譯有少許錯誤的地方。

可以嘗試看這個中文文檔：

1. 本人加持翻譯，改進了官方部分翻譯錯誤。

2. 與英文倉庫隨時同步。

當然，本人翻譯可能也會有錯誤的地方，可以在這裡 - vuefe/vuejs.org 給我提 pr 改進。

先說你能看懂多少，再說它怎麼樣吧。

我感覺寫的非常好，整個文檔介紹Vue2.0的整個學習路線和特性都是循序漸進，然後，相比react，vue2.0確實對很多問題都提出了更加優秀的解決方案，很棒！

文檔總歸是文檔，他並不是一本vue.js入門到精通教程，所以說題主遇到的問題可能是對於vue文檔中涉及到的各種大前端技術棧以及各種前端工程化涉及到的專業名詞不是很了解。而不是文檔本身的問題。

我的知乎專欄裡面有一篇講vue.js相關技術棧的教程可以作為一個入門引導題主可以點開我頭像進去我的專欄看看。

服了，Vue 的中文文檔都能覺得爛。。。題主是無腦黑吧 -。-

首先，請你找准自己的位置。

究竟是你看不懂，還是翻譯爛？

如果你是一位大牛，你認為vue的中文文檔翻譯的很爛的話，我覺得你應該首先去開源社區去提issue/PR，去把你所認為的好翻譯提交上去，或者你可以直接去看英文文檔。而不是來知乎提一個噴vue翻譯爛這種沒營養問題。

如果是你本身技術菜，看不懂文檔的話，還要提這個問題，那你就很棒棒哦！

人不行還要埋怨路不平。

不但不爛

反而是我見過的最優秀的中文文檔之一

讀起來吃力說明可能你的知識積累還不夠學習vue

推薦先吃透es5/es6的語法基礎,研究一下模塊化的思想後再來看這個文檔

vue文檔只有一點我想吐槽, 例子都是es5寫的..而實際使用都是es6,有點坑

可能我見識比較少，我覺得vue中文文檔是最好的之一，我就是看著文檔一步步學習，現在項目都上線了……

不是爛，是寫的很簡潔和很優雅。題主說讀不懂，那你可能是js基礎不夠，vue文檔第一句就寫了：面相中級前端工程師

看到一篇文章引用到了vue.js官方文檔的內容如下

比如這段：「獨立構建包括編譯和支持template選項」，這段話看起來就非常吃力（語法不通順）。

不過目前官網這段話已經改過來了：

說明官方的文檔也在不斷進步中。但總的來說，官方文檔對我這種閱讀能力不強，技術水平不怎麼樣的小白來說，閱讀起來還是比較費勁的。

但是，這也不能阻止我學習的步伐，因為當我能把文檔吃透了的時候，對我的水平也是一種巨大的進步。

覺得還好啊。。寫的很清楚。感覺Vue的中文文檔相當棒。雖然例子裡邊的代碼和項目中實際寫的代碼很不一樣。文檔這種東西不就是說明白怎麼用就好了么，具體不會寫的話，可以在github上找幾個好一點的開源項目看看人家是怎麼寫的呀。

前端初學者，挺喜歡Vue的

vue的中文文檔本來就有一些語句挺奇怪的，像機翻，一些人嘲諷提問的人也挺奇怪的

我覺得是我見過的國內項目里文檔最好的

寫的還是挺不錯的，總體來說挺不錯

就是例子部分寫的不明，不像php手冊裡面例子那麼多，java手冊裡面那麼清晰的目錄結構，vue需要你的豐富的大膽想像和不斷的假設嘗試

還有就是內容不全，組件的template標籤我竟然在手冊裡面壓根沒看到，要不是我在別人的項目裡面看到還有個template的話，我都不曉得還有這用法

vue文檔寫的可以啊但是這麼多人在跪舔讓人很噁心

樓主真的是無腦黑嗎？三大框架裡面，有這麼友好的官方文檔嗎

我到現在為止，沒見過中文文檔比 vue 更好更詳細更容易引導人上手的框架/庫，找個 pm 跟著做都能寫代碼了。