Nodejs安装、配置与快速入门

Nodejs是现代JavaScript语言产生革命性变化的一个主要框架,它使得JavaScript从一门浏览器语言成为可以在服务器端运行、开发各种各样应用的通用语言。在不同的平台下,Nodejs的安装和配置也各有不同。


由于Nodejs版本更迭频繁的特点(这一点和Python非常类似,也是这种充满活力的语言的共同特点),用户的不同项目可能在不同版本的Nodejs下开发进行(这些版本可能由于对第三方库版本依赖等不同原因而无法互相兼容),因此,一般建议通过安装版本管理器NVM ( Node Version Manager)来进行多版本的安装和使用(类似于Python语言的VirtualEnv或者Conda版本管理工具)。


Nodejs安装、配置与快速入门


1.Windows系统安装与配置Nodejs


虽然在Windows平台下,nvm-windows来进行多版本管理,但实际安装和使用体验并不好,因此本文仅介绍Windows下nodejs常规安装方式。并强烈推荐在日常开发中使用windows系统下内置的linuxs发行版WSL或者纯粹的linux发行版如Ubuntu以替代Windows,参见Windows 10安装与管理WSL体验原生Linux系统.


Windows下的Nodejs安装可以通过官方网站的安装包进行安装,也可以通过国内镜像例如清华大学开源镜像站或者淘宝镜像站选择相应版本并进行下载安装。


安装完成后,在命令行中输入以下命令,如果正常显示已安装的nodejs版本,则安装完成。否则可能需要手动设置环境变量到安装目录下。


<code>node -v
npm -v/<code>


2. MacOS系统安装与配置Nodejs


在MacOS系统下,可以通过从官方网站或者镜像站下载安装包pkg安装包的方式或NVM方式进行安装。一般来说不推荐直接用安装包的方式在系统中安装nodejs。在MacOS系统下,要安装NVM,需要先安装MacOS的命令行工具(Command Line Tools/可以与XCode一起安装或者单独安装)。参考说明文档单独安装时,需要在MacOS终端中输入以下命令:


<code>xcode-select --install/<code>


安装后的Command Line Tools在MacOS系统下述路径中。


<code>/Library/Developer/CommandLineTools//<code>


Nodejs安装、配置与快速入门


3.通过NVM安装与配置Nodejs(推荐)


在MacOS或者Linux系统中,推荐使用NVM来安装Nodejs。在使用Windows系统时,推荐使用WSL内置Linux子系统进行开发,并通过NVM进行Nodejs版本安装和管理。


3.1 在命令行通过curl或wget命令安装NVM(以下命令二选一):


<code>curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash/<code>


上述脚本会把NVM下载到 /.nvm文件夹下并将下面脚本添加到终端的配置文件中,根据使用的终端不同,配置文件可能是下面文件的某一个(/.bash_profile,/.zshrc./.profile或者~/.bashrc)


<code>export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \\. "$NVM_DIR/nvm.sh" # This loads nvm/<code>


3.2 NVM版本管理器常用命令


安装完NVM后,可以在命令行中输入nvm查看nvm命令行帮助文件,常用的nvm命令包括:


<code>nvm current #查看当前正在使用的node版本
nvm ls #列出本地已安装的node版本
nvm ls-remote #列出远程所有版本可通过 |grep v12.* linux管道命令来进行筛选
nvm install v12 #安装v12版本的nodejs,如果不指定具体版本,默认安装当前大版本的LTS版
nvm install --lts #安装lts版本node
nvm uninstall --lts #删除某个node的lts版本
nvm use v12 #使用v12版本的nodejs
nvm use system #如果操作系统中已经安装有nvm可识别的nodejs,该命令会使用系统中的nodejs
nvm alias default v12 #设置操作系统别名,该命令将v12别名设置为default,可通过nvm use defaul使用/<code>


需要注意的是,通过nvm安装并管理的各个不同版本,相互之间是各自独立的,因此,在一个版本中安装的全局安装包,并不会影响其他版本。这也正是nvm的优势所在。

默认情况下,nvm从nodejs海外官网直接下载相应版本,可以通过修改环境变量来使用国内淘宝镜像等进行加速。参考命令如下:


<code>export NVM_NODEJS_ORG_MIRROR=https://npm.taobao.org/mirrors/node/<code>


Nodejs安装、配置与快速入门


4. Linux系统下通过预编译二进制文件安装


在用于生产环境的电脑上,可能仅需要运行一个特定版本的nodejs并配置相应环境,这时就不需要通过nvm包管理器进行管理与安装,只需要下载需要的版本进行安装与配置即可。推荐从国内镜像站点下载预编译的文件。如清华大学开源镜像站。

v13.5.0 linux x64

v8.16.1 linux x64


v12.14.0 linux x64(稳定推荐)


使用wget或者curl下载源码并解压缩,将解压缩后的文件移动到常用的安装文件夹并分别为node,npm和npx创建软链接。


<code>tar xvJf  node.tar.xz #解压缩下载的安装包
sudo mv node /usr/node #将安装包移动到需要安装的目录下
#创建软连接,使得在bash下可以直接使用node相应命令,需要注意的是,通过这种方式安装的话,后续安装的
#全局npm包也需要每个单独配置软连接。要简化这一步骤,需要把nodejs包添加到linux的环境变量中

sudo ln -s /usr/node/bin/node /usr/local/bin/
sudo ln -s /usr/node/bin/npm /usr/local/bin/
sudo ln -s /usr/node/bin/npx /usr/local/bin//<code>


5. npm包管理器的配置与使用


5.1 配置npm使用国内软件仓库(推荐)


使用npm默认的国外仓库安装时,速度很慢,因此需要通过修改软件仓库为国内镜像(推荐淘宝)进行加速。可以通过阿里的cnpm或者直接设置仓库来实现。


修改npm或yarn仓库为淘宝镜像及恢复默认的官方镜像命令分别如下:


<code>#设置npm淘宝镜像
npm config set registry http://registry.npm.taobao.org/
#设置yarn淘宝镜像
yarn config set registry http://registry.npm.taobao.org/

#设置npm为官方镜像
npm config set registry https://registry.npmjs.org/
#设置yarn为官方镜像
yarn config set registry https://registry.yarnpkg.com


#安装阿里cnpm工具来替代默认npm,安装后可使用cnpm命令替代npm
$ npm install -g cnpm --registry=https://registry.npm.taobao.org

#查看当前镜像仓库路径
npm get registry
yarn config get registry

# 代码审查
npm audit/<code>


5.2 npm使用入门


npm是使用最广泛的nodejs包管理器(近几年出现的yarn是另外一个流行的node包管理器),可以用于方便的管理node项目中第三方包的管理和依赖问题,使nodejs项目摆脱依赖复杂性带来的种种问题。npm包管理器最常用的功能分为全局安装和项目安装两种。其中,全局安装的包可以在node全局可见,这样的安装方式可能会污染node版本环境,也不利于项目的移植,因此,除了一些必要的命令行工具和通用的包之外,不建议使用全局安装包。


使用下列命令进行全局包安装


<code>npm i -g pacakge-name/<code>


对于仅需要在某个项目中使用的包,可采用局部安装的方式。初始化nodejs项目时,可以在项目根目录下通过下列命令来生成项目的package.json文件,对于angular、nestjs等框架,在生成新项目时会自动生成相应的package.json文件。


<code>npm init/<code>


生成package.json文件后。要在本地安装和管理nodejs包,都可以在根目录下通过npm命令完成。


<code>npm i package-name #在项目中安装名为package-name的包,但并不保存到项目包列表中,不推荐该方法
npm i package-name --save #安装package-name包,并保存到项目依赖清单中
npm i package-name --save-dev #安装package-name包,并保存在开发依赖清单中,在生产环境中不安装
npm uninstall package-name #卸载某个包
npm update package-name #升级某个包的版本
npm i [email protected] --save #安装指定版本的package-name包
npm search package-name #搜索某个包

npm ls -g #列出全局安装的所有包
npm cache clear #清空npm本地缓存,一般在系统出现问题时处理故障使用/<code>


通过--save和--save-dev参数安装的所有包,都可以在package.json文件的依赖项中看到。

当然,除了下载和使用现有的第三方包之外,也可以在npm官网发布自己的npm包,供自己和他人(私有仓库需要付费,公有仓库免费)使用。这需要注册账号,并通过npm adduser命令添加自己的用户名,详细说明可参见相关官方文档。


6. 团队常用npm安装包


  • TypeScript包


<code>npm i -g typescript #安装TypeScript语言包
tsc helloworld.ts #使用TypeScript编译.ts文件/<code>


  • 安装Angular命令行工具及开始新项目


<code>npm install -g @angular/cli
ng new my-app
cd my-app
ng serve --open #启动angular开发服务器
#打开浏览器并访问http://localhost:4200/<code>


  • 安装Nestjs命令行工具及开始新项目


<code>npm i -g nestjs/cli #安装命令行工具
nest new my-app #新建项目
cd my-app #进入新项目
npm run start #运行项目
#打开浏览器并访问http://localhost:3000/<code>


  • light-server轻型调试服务器
    安装


<code>npm i -g light-server/<code>


示例


<code># Examples:
$ light-server -s . -p 7000
$ light-server -s dist --http2 -o
$ light-server -s dist --historyindex '/index.html'
$ light-server -s . -w "*.js, src/** # npm run build && echo wow!"
$ light-server -s . -x http://localhost:8000
$ light-server -s . -x http://localhost:8000 --servePrefix /assets
$ light-server -s . -b 10.0.0.1
$ light-server -x http://localhost:9999 --proxypath "/api" -w "public/**"
$ light-server -s static -w "**/*.css # # reloadcss"
$ light-server -c .lightserverrc
& light-server -s . -p 8000 -w "src/**/*.js # npm run js # no-reload"/<code>


7. nodejs开发常用资源


  • NVM版本管理器仓库
  • NPM包管理器官网
  • NPM淘宝镜像首页
  • 清华大学开源软件镜像站
  • Nodejs中文网
  • 菜鸟教程网nodejs快速入门教程
  • Angular中文官网
  • Nestjs中文文档


分享到:


相關文章: