利用vscode调试nodejs代码实践总结

2018.5.12更新

最近在用vscode 1.23版本的时候发现outDir不可使用了，建议这么改吧，直接program采用编译后的文件，而后打开sourceMaps，同时在babel编译的时候本身搞--watch及时生成.map文件便于vscode索引;若是你要编译其余语言，其实能够在package.json当中添加scripts，经过tasks.json来在debug以前进行编译，下面展现出.vscode下的两个文件，此为babel方法，其余相似

.launch.json

"configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "启动程序",
      "program": "${workspaceFolder}/lib/login.js",
      "sourceMaps": true,
      "preLaunchTask": "build" // 等于下面`label`值
    }
  ]

tasks.json

{
  "version": "2.0.0",
  "command": "npm",
  "tasks": [
    {
      "label": "build",
      // 合起来就是`npm run build`
      "type": "npm",
      "script": "build"
    }
  ]
}

package.json

"scripts": {
    "build": "babel src --out-dir lib --source-maps"
  },

实际上这样较慢，建议单独在build加watch，而后直接不用preLaunchTask

前言

以前一直习惯了用浏览器来调试代码，偶尔想调试一下node包中的代码，或者本身想写一个小的node插件无从下手，不知道该怎么调试，通过查找资料和向导师请教实践了一下这个过程

1. vscode概述

Visual Studio Code(如下简称vscode)是一个很强大的编辑器，相对而言比较轻量，由于我一般喜欢webstorm，webstorm自动保存和错误提示的特性深受我喜好，可是对于调试nodejs来讲，vscode则更具备它的优点所在。vscode支持windows，OS X和Linux三种环境，而且能够安装扩展插件，于是能够知足绝大多数人的要求，安装配置非本文所要讲述的内容，请自行查找，本文着重讨论如何用vscode更好的调试node代码，但愿能对你们有所帮助。

2. vscode界面

左上角依次是项目目录，搜索，版本管理git相关(左下角为当前分支)，调试，其余扩展插件 ，其余的均为中文标注，不解释，都是我们必要的，这几个若是没有的建议调出来这都是调试很必要的几个东西，能够去到菜单栏的查看中逐一调出

3. 调试前置条件：launch.json配置

点击图中左数第四个按钮，也就是调试，而后点击图中红框便可打开launch.json

"configurations": [
        {
            "type": "node",
            "request": "launch",
            "name": "Launch Program",
            "program": "${workspaceFolder}/src/extract-cli.js",
            "args": ["--output", "output.pot", "${workspaceFolder}/test/product_group.vm"],
            "outDir": "${workspaceFolder}/dist",
            "sourceMaps": true
        }
    ]

type和request不用改，默认就能够，request为launch时用F5直接能够启动调试，request为attach按照官网解释是关联到已经运行的一个程序，可是此处能够无论，咱们就用vscode自带的调试器进行调试就好。

program这个参数是指定要运行的js入口文件，其中${workspaceFolder}为当前打开的项目目录，.vscode目录会自动生成在此目录下，launch.json也在此目录下

args也是个比较重要的，好比该例，我执行命令gettext-extract --output output.pot input.vm 那么args的做用其实就是传入命令后面的参数，每一个空格之间要分开，写成args的某个子元素

sourceMaps对于编写es5代码来讲这个参数没有什么卵用，可是对于写es6,TypeScript等就十分有必要了，这个参数的值为true时会利用编译过程生成的map来进行源码和编译后的代码进行对应，这样在源码打断点，就能够愉快的进行咱们的调试了

outDir是用来标注编译后代码的生成目录的，帮助vscode进行查找

下面讨论下关于编译先后的对应关系这件事

• 我这边是用的babel来进行编译的，通过尝试，program参数若是直接指向编译后的文件，vscode奇迹般的能够本身去寻找到源码文件，这对于咱们的调试是最简单的方式了
• 若是program指向你编写的文件，那么须要提供一个outDir参数,只要配置到编译生成目录就行了。
• 其余：目测不须要sourceMaps还有编译成成.js.map若是你调试遇到了问题请尝试将sourceMaps设置为true并让编译工具生成map文件

4. 调试代码

只要在你调试的代码左边点击一下，只要是红色的，说明此处断点可行，如图所示

直接按F5便可开始调试，会在界面上出现相似于chrome的那几个单步跳过，单步调试等等，使用方法相似chrome,只是快捷键稍有不一样

而后点击左侧上面介绍的调试按钮，会看到运行到某一步的变量，还有调用堆栈状况，如图所示

5. 其余

捎带介绍一下本文使用的babel和命令行入口相关的知识

• 打开package.json，会发现有一个bin的配置,这么配置再npm install的时候就会将这两个命令加入到node_modules/.bin当中，而后就能够用作命令行了

"bin": {
    "gettext-compile": "./dist/compile-cli.js",
    "gettext-extract": "./dist/extract-cli.js"
  }

• babel执行命令时能够加--source-maps true来生成map文件，若是遇到我上面说到问题的才会用到这个，估计其余的编译工具也会有；另外，咱们修改源文件以后，想当即重启调试来进行验证，每次都本身执行命令很麻烦，那么babel自身支持--watch参数，能够监控文件变化，这样咱们就能够实现简单的自动化
• babel或者其余的命令行命令写的很长，不容易记住，那么咱们就能够将其写在package.json当中,以下就是讲babel编译写在其中，能够执行npm run prepublish便可

"scripts": {
    "prepublish": "babel  --watch --presets es2015 --plugins transform-object-assign --source-maps true src --out-dir dist/"
  }

参考资料：

1. 官网提示文档
2. [译]Visual Studio Code文档其4—调试
3. 采用easygettext源码来进行讲解的
4. babel --help的帮助