# 編寫插件 如果你打算自己寫一個 Gulp 插件，為了節約你的時間，你可以先完整地閱讀下這個文檔。 * [導覽](guidelines/) (必讀) * [使用 buffer](using-buffers/) * [使用 stream 來處理](dealing-with-streams/) * [測試](testing/) ## 它要做什么？ ###?流式處理文件對象（Streaming file objects） gulp 插件總是返回一個 [object mode](http://nodejs.org/api/stream.html#stream_object_mode) 形式的 stream 來做這些事情： 1. 接收 [vinyl File 對象](http://github.com/wearefractal/vinyl) 2. 輸出 [vinyl File 對象](http://github.com/wearefractal/vinyl) 這通常被叫做 [transform streams](http://nodejs.org/api/stream.html#stream_class_stream_transform_1) (有時候也叫做 through streams)。transform streams 是可讀又可寫的，它會對傳給它的對象做一些轉換的操作。 ### 修改文內容 Vinyl 文件可以通過三種不同形式來訪問文件內容： * [Streams](dealing-with-streams/) * [Buffers](using-buffers/) * 空 (null) - 對于刪除, 清理, 等操作來說，會很有用，因為這時候內容是不需要處理的。 ## 有用的資源 * [File object](https://github.com/wearefractal/gulp-util/#new-fileobj) * [PluginError](https://github.com/gulpjs/gulp-util#new-pluginerrorpluginname-message-options) * [event-stream](https://github.com/dominictarr/event-stream) * [BufferStream](https://github.com/nfroidure/BufferStream) * [gulp-util](https://github.com/wearefractal/gulp-util) ## 插件范例 * [sindresorhus' gulp plugins](https://github.com/search?q=%40sindresorhus+gulp-) * [Fractal's gulp plugins](https://github.com/search?q=%40wearefractal+gulp-) * [gulp-replace](https://github.com/lazd/gulp-replace) ## 關于 stream 如果你不熟悉 stream，你可以閱讀這些來 * https://github.com/substack/stream-handbook (必讀) * http://nodejs.org/api/stream.html 其他的一些為 gulp 創建的和使用的，但又并非通過 stream 去處理的庫，在 npm 上都會被打上 [gulpfriendly](https://npmjs.org/browse/keyword/gulpfriendly) 標簽。