Ubuntu 16.04 Node.js环境：browser-sync安装疑问及gulp正确安装方法

一、如何判断Browser-Sync是否安装成功？ #

不管你是全局安装还是局部安装，都可以用以下方法快速验证：

• 全局安装验证：在终端直接运行 browser-sync --version，如果能正常输出版本号，说明安装成功；如果提示「command not found」或其他报错，那就是没装好。
• 局部安装验证：进入你的项目目录（/var/www/html/nodejs/），运行 npx browser-sync --version，或者查看项目根目录的package.json文件，看dependencies或devDependencies里有没有browser-sync这个包。

二、Browser-Sync安装异常的常见原因 #

结合Ubuntu 16.04的环境，大概率是这几个问题导致的：

1. 权限问题：
   Ubuntu默认的npm全局包目录属于root用户，直接运行npm install -g browser-sync不加sudo会因权限不足安装失败；但如果用了sudo，后续可能出现文件权限异常（比如node_modules目录归root所有，普通用户无法读写），导致运行时报错。
2. Node.js版本不兼容：
   Ubuntu 16.04自带的Node.js版本通常是v4.x左右，而新版Browser-Sync要求Node.js版本至少v12以上，版本过低会导致依赖下载失败或编译错误。
3. 网络/源的问题：
   默认的npm源在国内访问可能不稳定，导致包下载不完整或超时，进而触发安装异常。
4. 局部安装路径错误：
   如果是局部安装Browser-Sync，你没在项目目录下执行安装命令，或者运行时没通过npx调用，也会提示命令找不到。

三、Gulp的正确安装步骤 #

Gulp 4.x及以后的版本需要分开安装全局CLI和项目本地核心包，具体步骤如下：

1. （可选但推荐）升级Node.js版本
   Ubuntu 16.04自带的Node版本太老，建议用nvm（Node版本管理器）安装LTS版本（比如v14或v16），避免兼容性问题：

   # 安装nvm
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
   # 重启终端后安装Node.js LTS版本
   nvm install --lts
   

2. 全局安装Gulp CLI
   CLI是用来在终端执行gulp命令的工具，全局安装一次即可：

   # 如果权限不够，前面加sudo，或者配置npm全局目录到用户目录（更安全）
   npm install -g gulp-cli
   

3. 项目本地安装Gulp核心包
   进入你的项目目录/var/www/html/nodejs/，先初始化package.json（如果还没有的话）：

   npm init -y
   

   然后安装Gulp到开发依赖：

   npm install --save-dev gulp
   

4. 验证安装
   在项目目录下运行：

   gulp --version
   

   如果能同时显示CLI version和Local version，说明安装成功了。

额外小贴士 #

为了避免权限问题，建议配置npm的全局包目录到用户个人目录：

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
# 把这个路径加到环境变量里，编辑~/.bashrc或~/.profile，添加一行：
export PATH=~/.npm-global/bin:$PATH
# 生效配置
source ~/.bashrc

之后全局安装npm包就不用加sudo了，也不会出现权限问题。

内容的提问来源于stack exchange，提问作者Philipp M