Browsersync 中文文档

在这里，你可以找到所有关于使用 Browsersync 的说明信息。我们提供了详尽的信息，覆盖了 API、Grunt/Gulp 集成 和所有可用的参数等。

In this section:

全局安装

如果你希望在任何目录下都可以在命令行中运行 Browsersync， 可以通过如下命令安装到 全局 环境。

$ npm install -g browser-sync

局部安装

这是推荐的 Browsersync 用法 - 局部安装到每个项目下。这种 方式可以将 Browsersync 作为依赖项添加到 package.json 文件中。

$ npm install browser-sync --save-dev
警告 - 不要使用 sudo！ 如果你在 Mac OSX 下（全局或局部）安装 Browsersync 并遇到问题， 几乎全部是 npm 权限的问题。查看 npm 文档 了解如何一劳永逸地解决这个问题 - 仅需2分钟 :)

Browsersync 的工作原理是：初始请求时在 <body> 标签后面插入异步加载的脚本标签 (<script async>...</script>) 。 为了能够正常工作，<body> 标签必须存在。或者，你 可以利用 snippetOptions 提供一段自定义的规则。

Having trouble installing on在 Windows 上安装 Browsersync 时遇到了问题吗？最常见的原因是 npm 在编译 Browsersync 的某些依赖模块时出错了， （例如 [node-gyp](https://github.com/TooTallNate/node-gyp） 需要 Visual C++ 运行库。

解决此问题的方法是安装 Visual Studio。 在撰写本文时（2015 年 2 月），能够正常编译的运行库是 Visual Studio 2013 Update 4。 你可以通过以下命令告诉 npm 你使用的是哪个版本的 Visual Studio ：

npm install -g browser-sync --msvs_version=2013

安装完 Visual Studio 后，npm 应该不会再引发错误了，但是还是会出现警告信息。 据我们所知，这并不影响 Browsersync。

有时，根据您的网络状况，操作系统会有多个外部 IP 地址。如果出现这种情况，目前 Browsersync 只选取第一个。

你可以使用类似 dev-ip 的工具列出当前机器上所有可能的外部 URL， 然后配置 host 参数 。

This site is open source on Github & we welcome corrections/improvements.

Sections