安装及使用
安装
Taro 项目基于 node，请确保已具备较新的 node 环境（>=12.0.0），推荐使用 node 版本管理工具 nvm 来管理 node，这样不仅可以很方便地切换 node 版本，而且全局安装时候也不用加 sudo 了。
CLI 工具安装
首先，你需要使用 npm 或者 yarn 全局安装 @tarojs/cli，或者直接使用 npx:
# 使用 npm 安装 CLI$
npm install -g @tarojs/cli
# OR 使用 yarn 安装 CLI$
yarn global add @tarojs/cli
# OR 安装了 cnpm，使用 cnpm 安装 CLI$
cnpm install -g @tarojs/cli
请注意
值得一提的是，如果安装过程出现sass相关的安装错误，请在安装 mirror-config-china 后重试。
npm install -g mirror-config-china
查看 Taro 全部版本信息
可以使用 npm info 查看 Taro 版本信息，在这里你可以看到当前最新版本
npm info @tarojs/cli
由图第 1 行可知最新版本，如果你用的是 beta 或者 canary 你可以通过 dist-tags: 下面那行看到最新的版本。
项目初始化
使用命令创建模板项目：
taro init myApp
npm 5.2+ 也可在不全局安装的情况下使用 npx 创建模板项目：
npx @tarojs/cli init myApp
在创建完项目之后，Taro 会默认开始安装项目所需要的依赖，安装使用的工具按照 yarn > cnpm > npm 顺序进行检测。一般来说，依赖安装会比较顺利，但某些情况下可能会安装失败，这时候你可以在项目目录下自己使用安装命令进行安装：
# 进入项目根目录
cd myApp
# 使用 yarn 安装依赖
yarn
# OR 使用 npm 安装依赖
npm install
# OR 使用 pnpm 安装依赖
pnpm install
# OR 使用 cnpm 安装依赖
cnpm install
编译运行
使用 Taro 的 build 命令可以把 Taro 代码编译成不同端的代码，然后在对应的开发工具中查看效果。
Taro 编译分为 dev 和 build 模式：
- dev 模式（增加 --watch 参数）
- build 模式（去掉 --watch 参数）
- dev 模式生成的文件较大，设置环境变量
NODE_ENV
production
微信小程序
编译命令
# yarn
yarn dev:weapp
yarn build:weapp
# 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
# watch 同时开启压缩
set NODE_ENV=production && taro build --type weapp --watch
# CMD$
NODE_ENV=production taro build --type weapp --watch
# Bash
小程序开发者工具
下载并打开微信开发者工具，然后选择项目根目录进行预览。
需要注意开发者工具的项目设置：
- 需要设置关闭 ES6 转 ES5 功能，开启可能报错
- 需要设置关闭上传代码时样式自动补全，开启可能报错
- 需要设置关闭代码压缩上传，开启可能报错
常见问题
保持 CLI 的版本与各端依赖版本一致
在使用 Taro 进行多端开发中，请保持 Taro CLI 的版本与你项目的依赖版本一致，否则可能会出现编译错误或者运行时错误。
如果发现不一致的情况可以使用 Taro 升级命令 taro update self [版本号] 和 taro update project [版本号]来分别将 CLI 和项目依赖升级到指定版本； 或者也可以手动安装相应版本 CLI，修改 package.json 依赖版本号，然后重装依赖来解决。
# 使用Taro 升级命令更新CLI版本到最新版本$
taro update self
# 使用Taro 升级命令更新CLI版本到指定版本$
taro update self [版本号]
# 使用Taro 升级命令将项目依赖升级到与@tarojs/cli一致的版本$
taro update project
# 使用Taro 升级命令将项目依赖升级到指定版本$
taro update project [版本号]
如果你所使用的 Taro CLI 版本为 3.0.9，而项目里使用的依赖版本为 3.0.10，则有可能会出现问题，这时请将你的 Taro CLI 版本更新至项目依赖版本号相同的版本，如果还是出现问题，请向我们提出 Issue。
Taro 多版本共存问题
很多开发者曾经使用 Taro 旧版本开发过项目，已经在全局安装了 Taro，但是想同时体验到 Taro 3，应该如何进行操作？
我们提供了两种思路：
- 如果是需要新创建 Taro 3 项目，可以使用 nvm
- 如果是部分已有项目需要升级到 Taro 3，可以在这些项目本地安装相应版本的 Taro CLI，这样通过
yarn
npm
yarn add @tarojs/cli
回到某个版本
需要安装某个固定版本，或者回到某个版本，例如我们要安装 1.3.9 ， 则如下：
# 使用 npm 安装 CLI$
npm install -g @tarojs/cli@1.3.9
# OR 使用 yarn 安装 CLI$
yarn global add @tarojs/cli@1.3.9
# OR 安装了 cnpm，使用 cnpm 安装 CLI$
cnpm install -g @tarojs/cli@1.3.9
taro启动微信小程序报错Error: Cannot find module ‘@tarojs/plugin-platform-weapp‘ from...
taro启动微信小程序报错Error: Cannot find module ‘@tarojs/plugin-platform-weapp’ from…
报错提示如下图：
问题原因：项目使用的cli版本与本地使用的版本不一致
解决办法：找到项目的package.json文件，查看taro版本，安装对应版本
卸载tarojs
npm uninstall -g @tarojs/cli
安装指定版本，比如你当前的版本为1.3.33：
npm install -g @tarojs/cli@1.3.33
再次运行：
npm run dev:weapp
