NodeJS 学习笔记

July 04, 2015

前言: 关于NodeJS

Chrome V8 Javascript 引擎上的运行时(runtime)。官方网站 http://nodejs.org ，开源地址 https://github.com/nodejs/node 。

第二章安装配置

2.1 安装及配置

均去官网下载对应的系统版本进行安装，下载地址 https://nodejs.org/en/download/
- 2.1.1 Windows 下安装
  
  下载对应的 msi 或 exe 文件，双击安装，如下图，一并安装的还有 Node 包管理器 (Node Package Manager 又叫 NPM)
  
  可以自由的选择安装位置
  
  选择安装的内容
  
  多个下一步后，完成安装，安装位置是上图中你定义的位置。
  
  在命令行中运行 node -v，可以看到你所安装的 nodejs 的版本，运行 npm -v 则可以看到你的 NPM 的版本。
- 2.1.2 Mac OSX 下安装
  
  下载对应的 APK 文件，双击安装，如下图，一并安装的还有 Node 包管理器
  
  在多个继续的点击后，进入最后一步
  
  可以看出，Node 的安装位置是 /usr/local/bin/node，而 NPM 的安装位置是 /usr/local/bin/npm
  
  在终端中运行 node -v，可以看到你所安装的 nodejs 的版本，运行 npm -v 则可以看到你的 NPM 的版本。
  
  还可以通过 homebrew 来安装，访问 http://brew.sh/ 安装好 homebrew 后，在终端中输入 brew install nod 即可安装
- 2.1.3 Linux 下安装
  
  一般情况下，可以通过不同的发行版本直接安装，比如 Debian/Ubuntu 就可以直接用 sudo apt-get install nodejs 来安装，其他发行版本类似。
  
  也可以用 nvm 来安装，先执行 wget -qO- https://raw.githubusercontent.com/creationix/nvm/v0.33.6/install.sh | bash 安装 nvm，然后直接安装 nodejs 即可。
  
  常用的 nvm 命令
```
nvm ls 列出本地已经安装的node版本
nvm ls-remote 列出所有的node版本
nvm install --lts 安装lts版本
nvm install  安装指定版本
nvm use  使用指定版本
nvm help  查看帮助 
```
- 2.1.4 编译源码安装
  
  因为 Linux 发行版本时间的缘故，有时候需要通过编译源码来安装，Windows 和 Mac OSX 下也可以编译源码的方式安装，但这里只介绍 Linux 下编译源码安装，以 Ubuntu 为例
  - 安装基本工具 g++ 编译 Node.JS，命令 sudo apt-get install g++
  - python 基本系统已经预置，版本需要 2.5+
  - libssl-dev 提供 SSL/TLS 加密的支持，命令 sudo apt-get install libssl-dev
  - 下载并编译源码安装将源码下载到系统系统中某一个地方，比如 ~ 目录下
```
wget https://nodejs.org/dist/v4.4.4/node-v4.4.4.tar.gz 
tar -xvf node-v4.4.4.tar.gz 
cd node-v4.4.4 
./configure 
sudo make 
sudo make install 
```
    完成安装。如同上面的操作，查看 nodejs 和 npm 的版本。
2.2 Node 包管理器

Node 包管理器 (Node Package Manager 又叫 NPM)，Node.JS 0.6 版本后，已经包含在 Node.JS 的发行包中，在安装 Node.JS 的同时会自动安装。如果你想手动安装，执行一下命令
```
curl http://npmjs.com/install.sh | sudo sh
```
完成安装，更多的新版本的获取可以访问官网 http://npmjs.com 。
2.3 多版本理器

因为 Node.JS 版本更新速度快，会存在新旧版本不兼容等问题，这时候需要用到了 Node.JS 的多版本管理器。直接通过如下命令安装
```
git clone https://github.com/tj/n.git //从服务器上 clone 到电脑端
cd n //进入文件夹
make install //安装
```
安装完成后，可以在 /usr/local/bin/n 中看到相关的文件，更多命令通过 n --help 查看。也可以通过命令 sudo npm install -g n 直接安装。如果需要升级 nodejs 版本，则使用命令 sudo n stable 来安装最新稳定版。有时候需要执行命令 sudo npm cache clean -f 清理缓存。

第三章 Node.JS 基础知识

3.1 Hello World

用任意编辑器新建一个文件，命名为 helloworld.js，里面写入如下内容
```
console.log('hello world');
```
console.log 将在后面详细讲解

在终端中进入 helloworld.js 文件所在的文件夹，执行
```
node helloworld.js
```
这时你会在终端中看到 hello world 文字的出现。这就是运行 Node.JS 程序最基本的方法。

更多的关于 Node 的用法，可以通过 node –help 查看。
3.2 模块

模块 (Module) 是 Node.JS 的基本组成，通常一个文件就是一个模块，通过 require 这个对象加载到程序中
```
var http = require('http');
```
这就是加载 http 这个模块。
- 3.2.1 模块的创建和加载
  
  通过 exports 这个对象来创建，exports 是模块公开的接口
```
var name; //定义一个变量
exports.setName = function(thisName) {
  name = thisName;
};
exports.useName = function(){
  console.log('hi ' + name);
};
```
  这里完成了一个模块的设计，保存文件为 module-name.js，通过 exports 这个对象把 setName 和 useName 设置为模块的访问接口。
  
  如上面所说，通过对象 require 加载到程序中进行使用
```
var nameModule = require('./module-name'); //模块的位置，该程序文件和模块文件在同一个文件夹下
nameModule.setName('tc'); //调用函数，有参数
nameModule.useName(); //调用函数，无参数
```
  保存文件为 name.js，执行该文件 node name.js 会得到结果 hi tc。
  
  需要注意的是，无论加载多少次 Module，最后的的输出结果都是由最后一个所确定，如
```
var nameModule1 = require('./module-name');
nameModule1.setName('tc');
      
var nameModule2 = require('./module-name');
nameModule2.setName('tcoder');

nameModule1.useName();
```
  保存文件为 name2.js，执行得到的结果是 hi tcoder ，而不是 hi tc。
- 3.2.2 单一对象的模块创建
  
  只把一个对象封装到模块中，如
```
function sayHi() {
  var name;
  this.setName = function(thisName) {
    name = thisName;
  };
  this.useName = function() {
    console.log('hi ' + name);
  };
};
module.exports = sayHi; //简化后的方式，复杂写法是 exports.sayHi = sayHi;
```
  保存文件为 sayhi.js，加载该文件
```
var sayHiC = require('./sayHi');
sayHello = new sayHiC();  //创建一个新对象
sayHello.setName('tc');
sayHello.useName();
```
  保存文件为 sayhic.js，执行该文件，同样可以得到 hi tc 这个结果。
3.3 包
- 3.3.1 包的创建
  
  包类似于函数库，类库，将镀铬功能封装起来，用于发布更新依赖管理和版本控制，Node.JS 根据 CommonJS 规范实现了包机制，用上面提到的 NPM 来管理包。按 CommonJS 严格规范，包主要有下面的内容组成
  - package.json 必须放在包的最顶层目录下
  - 二进制文件必须放在 bin 目录下
  - Javascript 代码放在 lib 目录下
  - 文档放在 doc 目录下
  - 单元测试放在 test 目录下
  前面说到的文件和模块是一一对应的，同样文件夹还可以是作为文件而被使用，基本的包就可以视为是一个文件夹的模块，比如，创建一个文件夹叫 apackage，在这个文件夹下创建一个 index.js 的文件
```
exports.bao = function () {
  console.log('hi package');
};
```
  如同模块的写法一样。在 apackage 这个文件夹外，创建一个新文件命名为 testpackage.js
```
var pg = require('./apackage');
pg.bao();
```
  运行该文件，可以得到 hi package，这个结果。这个就是如何把一个文件夹封装成一个包。
- 3.3.2 package.json 文件
  
  package.json 文件可以理解为包的配置文件，它定义了包的一些相关的信息，Node.JS 程序在调用一个包是 package.json 文件起了很重要的作用。更多关于它的说明请访问 https://docs.npmjs.com/files/package.json 本文件可以通过包管理工具 NPM 创建，npm init即可创建一个 package.json 的文件。
- 3.3.3 包的安装和管理
  
  包的管理由 NPM 搞定，安装包也非常方便 npm install package_name 即可完成包的安装，此时这种安装是安装在当前的目录下的，会自动生成一个 mode_modules 的文件夹，如果想安装全局模式的包则运行 npm install -g package_name，加上 -g 这个参数。
  
  注意：如果全局安装了，则不可以用 require 来进行使用，但可以 npm link 来消除这个限制，如果全局安装了amodule，则 npm link amodule 即可

update@20180507 : Nodejs 项目调试

最近在用 nodejs，koa，ejs 开发一个网站项目时总遇到一些问题，调试就显得非常重要，这里记录下一些调试的方式。

官方指南

Node.js 官方给出了一些调试指南的，查看这里，已经非常全面。

VSCode

点击左侧的 Debug，然后点击顶部的 Setting （齿轮），输入 node.js，在弹出的文件 lanuch.json 中更改 Program 路径为自己的执行的文件路径，如下

{
    // Use IntelliSense to learn about possible attributes.
    // Hover to view descriptions of existing attributes.
    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "type": "node",
            "request": "launch",
            "name": "Launch Program",
            "program": "${workspaceFolder}/app.js"
        }
    ]
}

最后点击顶部绿色的运行按钮开始运行即可。