如果你是使用 NPM 安裝,使用如下命令:
$ npm install -g @tarojs/cli
如果你是使用 Yarn 安裝,使用如下命令:
$ yarn global add @tarojs/cli
安裝完畢,測試一下是否安裝成功:

如你所見,版本號打印出來,說明已經(jīng)安裝好了。
使用命令創(chuàng)建模板項目:
$ taro init myApp
NPM 5.2+ 也可在不全局安裝的情況下使用 npx 創(chuàng)建模板項目:
$ npx @tarojs/cli init myApp
命令行上會提示 Taro 即將創(chuàng)建一個新項目!,接著 Taro 會提示你輸入項目介紹,我們這里輸入 我的第一個 Taro 項目;而后讓你選擇是否使用 TypeScript,筆者不使用 TypeScript ,輸入 n ; 接著提供 CSS 預(yù)處理器選擇,有 Sass、Less、Seyless,筆者選擇了 Sass;然后是選擇模板,筆者選擇默認模版,完成后,Taro 開始創(chuàng)建項目,自動安裝依賴,這里可能需要等待一會。

看到提示 請進入項目目錄 myApp 開始工作吧 后,進入項目目錄開始開發(fā),目前 Taro 已經(jīng)支持微信/百度/支付寶小程序、H5 以及 ReactNative 等端的代碼轉(zhuǎn)換,針對不同端的啟動以及預(yù)覽、打包方式并不一致。
微信小程序
選擇微信小程序模式,需要自行下載并打開微信開發(fā)者工具,然后選擇項目根目錄進行預(yù)覽。具體安裝的方法和使用請參考第 3 章《微信小程序開發(fā)入門與技術(shù)選型》里的 「微信小程序開發(fā)入門」。
微信小程序編譯預(yù)覽及打包:
# npm script
$ npm run dev:weapp
$ npm run build:weapp
# 僅限全局安裝
$ taro build --type weapp --watch
$ taro build --type weapp
# npx 用戶也可以使用
$ npx taro build --type weapp --watch
$ npx taro build --type weapp
百度小程序
選擇百度小程序模式,需要自行下載并打開百度開發(fā)者工具,然后在項目編譯完后選擇項目根目錄下 dist 目錄進行預(yù)覽。
百度小程序編譯預(yù)覽及打包:
# npm script
$ npm run dev:swan
$ npm run build:swan
# 僅限全局安裝
$ taro build --type swan --watch
$ taro build --type swan
# npx 用戶也可以使用
$ npx taro build --type swan --watch
$ npx taro build --type swan
支付寶小程序
選擇支付寶小程序模式,需要自行下載并打開支付寶小程序開發(fā)者工具,然后在項目編譯完后選擇項目根目錄下 dist 目錄進行預(yù)覽。
支付寶小程序編譯預(yù)覽及打包:
# npm script
$ npm run dev:alipay
$ npm run build:alipay
# 僅限全局安裝
$ taro build --type alipay --watch
$ taro build --type alipay
# npx 用戶也可以使用
$ npx taro build --type alipay --watch
$ npx taro build --type alipay
H5
H5 模式,無需特定的開發(fā)者工具,在執(zhí)行完下述命令之后即可通過瀏覽器進行預(yù)覽。
H5 編譯預(yù)覽及打包:
# npm script
$ npm run dev:h5
# 僅限全局安裝
$ taro build --type h5 --watch
# npx 用戶也可以使用
$ npx taro build --type h5 --watch
React Native
React Native 端運行需執(zhí)行如下命令,React Native 端相關(guān)的運行說明請參見 React Native 教程。
# npm script
$ npm run dev:rn
# 僅限全局安裝
$ taro build --type rn --watch
# npx 用戶也可以使用
$ npx taro build --type rn --watch
更新 Taro
Taro 提供了更新命令來更新 CLI 工具自身和項目中 Taro 相關(guān)的依賴。
更新 taro-cli 工具:
# taro
$ taro update self
# npm
npm i -g @tarojs/cli@latest
# yarn
yarn global add @tarojs/cli@latest
更新項目中 Taro 相關(guān)的依賴,這個需要在你的項目下執(zhí)行。
$ taro update project