Browsersync 说明文档

在这里,你可以找到所有你需要开始使用Browsersync的说明信息。我们拥有覆盖命令行的用法介绍,API,Grunt/Gulp和所有可用的选项(options)等信息。

在本节中将介绍以下4点:

Global Install(全局安装)

如果你想在任何目录的命令行中运行Browsersync ,可通过global命令进行全局安装。

$ npm install -g browser-sync

Local Install(本地安装)

我们推荐这种方式来安装 Browsersync - 通过本地安装到每个项目。这种方式的可以使依赖被添加到你的package.json文件里(gulp或grunt构建方式),以便其他人可以便捷使用。

$ npm install browser-sync --save-dev
警告 - 不要使用sudo! 如果你在 Mac OSX 下安装Browsersync并遇到问题时 - 无论是在(Global)全局还是在(Local)本地,它几乎总是因为你的NPM权限所引起的问题。查看相关 说明文档 了解如何一劳永逸来解决这个问题 - 只需2分钟:)

Browsersync的工作原理是在<body>标签之后插入初始请求的 (<script async>...</script>)异步脚本标记, 为了能够正常工作<body>标签必须存在。另外,您可以为使用 snippetOptions代码段自定义规则

如果你在Windows上安装Browsersync遇到了问题?最常见的原因是:"NPM抛出错误编译 Browsersync 时,缺少一些依赖关系 (如 node-gyp 需要 Visual C ++ 运行时库。)

解决这个问题的方法是安装 Visual Studio。在写这篇文章(2015年2月)的时间编纂工作正常使用Visual Studio2013 Update 4。然后,您可以告诉 npm 您通过以下命令使用Visual Studio的版本:

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

安装Visual Studio后 NPM不应该再抛出错误,但只是发出警告。据我们所知,它们不影响Browsersync。

当你安装好了Browsersync后并尝试在命令工具里启动Browsersync,系统却提示你“找不到该命令,无效命令”,这个时候请你不要沮丧,据我们所知,这个问题是由于环境变量里node路径存在问题,请尝试查看一下环境变量里node的路径。

有时候,这取决于你的网络,你的操作系统会报告多个外部IP地址。如果发生这种情况,Browsersync会使用第一个,但愿这是正确的。

你可以使用像 dev-ip的工具,列出所有可能的外部URL您的机器上,然后提供配置主机选项

你也可以访问Browsersync github的站点 & 或向我们反馈问题和建议。