[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?

一、安装VSCode和Node.js


记录环境配置:本文配置的环境主要针对单独JS文件的断点调试,主要是为了调试LeetCode里面的代码。

首先在官网下载对应的版本:https://nodejs.org/en/

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第1张图片

开始安装,可以自定义选择安装路径。

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第2张图片

这里选择Add Path,系统变量会自动设置,但是用户变量并没有自动设置,需要的话可以自己手动加一下。

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第3张图片

测试是否安装成功,在命令行输入node -v和npm -v,如果能显示出版本号说明安装成功,且已经有了正确的环境变量。

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第4张图片

       用户变量最好也手动自己添加一个比较稳妥,因为我之前没有加,有时候在VSCode中会出现node.js找不到路径的情况,虽然重启会解决问题,但是弹了两次我总觉得还有些不对劲,所以就还是加了一下,大家在安装的时候最好提前加一下。

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第5张图片

到这里,Node.js安装完成


二、VSCode配置


先在VSCode里面安装两个插件,一个是负责运行的Code Runner,一个是JS的语法提示JavaScript(ES6) code snippets。

原文链接:Luminary_aurora https://blog.csdn.net/qq_40197828/article/details/123930432

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第6张图片

创建json file

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第7张图片

Debug with VSCode

描述了在VS Code中怎样充分利用其强大的debug功能来调试web项目和源码调试(TypeScript)

原文:Debug with VSCode - 知乎

背景

之前在看一些github源码的时候看调试数据是非常非常吃力,不知道多少时间消耗在了console,rebuild,switch tab的这几个频率最高的步骤中,着实烦躁。首先回顾一下我自己之前在看一些库源码的过程,以rollup这个打包库为例,首先git clone下来,npm install后发现它也自动执行了打包过程,看了下package.json文件中的scripts字段,其中有prepare脚本命令,npm在执行npm install后就会自动执行这个script,这个命令又指向了npm run build,进而进行了自动打包过程。通常我都会在这个project下执行npm link然后重新重建个文件夹写自己的一些例子项目link到前面的project,这样看project下的源码或者console之后重新build,就能在例子项目实时能够调试到,其中执行npm run watch可以不用重新build。

这样真的很累!...需要开两个项目频繁切换,消耗时间,还一点都不灵活!下面就研究了下VSCode中强大的Debug功能,让我犹如坐上了火箭 ,并在此做个总结。

初识Debug Panel(牛刀小试)

下面是vscode中的debug panel

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第8张图片

最左边一列的第四个tab,之前的我看到过无数遍这个小蜘蛛,却从来没有打开过...,相信我,它会让你打开新世界的大门。(command+shife+D快捷打开此面板)

方便这节后面的演示,用VSCode打开一个空目录取名Hello,下面新建一个app.js,写个最简单的代码如下:

var hello = "Hello World"
console.log(hello)

然后点击小蜘蛛进入到debug面板,点击 下面的小齿轮图标

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第9张图片

如果你的项目根目录下有.vscode目录且下面有launch.json配置文件,则点击上面的小齿轮按钮会直接打开此 launch.json配置文件

这时会出现如下,让你选择调试环境,VSCode内置了Node.js环境,可以在插件tab安装其他语言的扩展,VSCode支持各种语言的调试,eg:PHP,Python,go,C/C++...我们直接选择Node.js环境

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第10张图片

选择后会直接打开一个launch.json文件并有如下配置:

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "node",
            "request": "launch",
            "name": "Launch Program",
            "program": "${file}"
        }
    ]
}

command+shift+E回到目录列表会看到多了一个.vscode目录,下面就是该launch.json文件,可以点击右下角的Add Configuration按钮,会弹出如下配置供选择,在这个配置文件里可以充分利用它的智能感知功能,我们选择Node.js: Launch Program

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第11张图片

它会自动帮我们生成该配置的常用项,我们将其中的"program": "${file}"改为"program": "${workspaceRoot}/app.js",在这个配置有挺多的内置变量可以直接使用,${file}就是当前所活跃的文件,${workspaceRoot}表示当前项目的工作根目录,完整的替换变量的列表可参考这里

在上面的配置字段中有个request字段,有两个值可以选择:"launch"  "attach",它表示VS Code中核心的两种调试模式。当时搞清这两种模式区别的时候也是有点晕,这也是取决与你项目中的工作流是怎样的,假如你调试的是web项目,通常你会在浏览器中已经直接打开项目了,这个时候我们可以使用attach模式,正如字面的意思,将debugger附加到你已经运行到的web项目,而launch就像字面意思是直接由编辑器启动这个程序,比如启动一个服务端项目或者上面我们的小例子,这个启动模式编辑器会自动把debugger附加到这个程序中。launch config 就像是作为一种debug模式直接启动app,而attach config 就像是debugger连接到正在运行的app。下面我们在web项目调试一节会有这两种模式的直观印象

在开始debug之前,我们先在app.js的第二行最左边打一个断点

configurations里面的name字段会显示在左边Debug一栏最上面的下拉列表里,点击小齿轮左边的框就可以选择刚才添加的配置,对应与configurations里面的name字段,选择Launch Program,然后点击左边的小绿色三角启动debug(F5),然后就可以看到程序暂停在刚才打的断点这行了

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第12张图片

可以看到最上面的工具栏就是所有的调试操作:

  • 继续/暂停 F5
  • 单步跳过 F10
  • 单步调试 F11
  • 单步跳出 ⇧F11
  • 重启 ⇧⌘F5
  • 停止 ⇧F5

左边的调试栏也显示出了程序里运行的所有变量,可以看到commonjs的模块变量也显示出来了__dirname,__filename,module,require...global下面也有所有的全局变量,调用堆栈也显示了程序中函数的调用顺序,这样你就可以在任何你想调试的地方打个断点,这个地方的所有信息就全部暴露出来了。下面我们可以看看怎样来调试web项目

调试web项目

我们用create-react-app官方脚手架创建一个简单app项目,在终端运行如下命令:

npx create-react-app debug-react  # npm 版本5.2以上
cd debug-react
npm start

可以看到浏览器自动打开并运行了这个简单web项目,为了方便调试看到效果,我们将App.js代码稍加改动如下:

//  App.js
// ...
function App(props) {
  const {
    link,
    text,
  } = props  // 这行打个断点
  return (
    
logo

Edit src/App.js and save to reload.

{text}
); } // ...

相应的index.js改动如下:

// index.js
// ...
ReactDOM.render(
    ,
    document.getElementById('root')
);
// ...

保存后浏览器自动刷新了,可以看到只是将渲染数据提取出来以props形式从父组件传入,接下来我们进行debug的配置

调试web项目需要安装一个利器,打开VS Code左边的扩展栏 ⇧⌘X ,然后输入chrome,选择并点安装 Debugger for Chrome 扩展,安装完后进入左边debug栏点击小齿轮 F5 在弹出的选择环境的下拉列表框中选择 chrome ,然后会自动打开Launch.json配置文件并有如下配置:

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "chrome",
            "request": "launch",
            "name": "Launch Chrome against localhost",
            "url": "http://localhost:3000",
            "webRoot": "${workspaceFolder}"
        }
    ]
}

你必须指定一个 url 或者 file 配置项启动浏览器,以上配置的url就是指向我们最上面的debug-react项目的本地服务url。如果指定了url,就要设置webRoot字段,其表示一个绝对路径指示本地服务的文件来自哪里,比如以上的webRoot配置会解析http://localhost:3000/index.js成为类似/Users/me/debug-react/app.js所以确保它设置正确

在启动调试之前确保之前的本地服务是跑着的,然后按 F5 启动debug调试,可以看到VS Code启动了个新的浏览器窗口,如果程序并没有停在之前的断点处,可以在刷新一下调试 ⇧⌘F5 ,可以看到如下效果了:

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第13张图片

相应的props和相关变量都可以在debug栏清晰的看到,都不用去看浏览器的调试了。

注意到上面的chrome调试配置的 request 类型是 launch,我们还可以尝试另一种调试方式,也就是"request": "attach"的调试方式,打开Launch.json配置文件,点击右下角的Add Cogfiguration选择Chrome: attach, VS Code自动生成了系列配置如下:

{
   "type": "chrome",
   "request": "attach",
   "name": "Attach to Chrome",
   "port": 9222,
   "webRoot": "${workspaceFolder}"
}

要进行远程调试必须的打开chrome的远程调试功能,并设置以上默认配置的远程调试端口,如下:

  • Mac
    在终端运行/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222, 会直接运行一个新的浏览器的窗口,然后将之前的debug-react项目重启一下npm start
  • Windows
    右击桌面的chrome的快捷方式,点属性=>目标框的后面添加--remote-debugging-port=9222,或者在命令行下执行/chrome.exe --remote-debugging-port=9222,重启一下debug-react项目

启动调试 F5 ,可能会让你选一个本地服务,选择debug-react即可,可以看到已经开始了debug调试:

点击以上绿色按钮重启一下,程序停在了断点的位置上了。注意attach并没有启动一个新的浏览器窗口,而是在你原有启动的窗口下开始了调试。将鼠标移到上图橙色正方图标上,显示的是断开连接,这也和之前我们所说的attach模式是把debugger连接到了已经启动的app上的说法一致,它没有像launch模式那样每次启动都会启一个新的浏览器窗口。

在调试react项目的时候会经常遇到render阶段数据还没出来,这跟react的生命周期有关,往往我们会多点几下单步调试或者单步跳过,其实打断点的时候支持多种断点,比如打条件断点,日志断点,函数断点等等...可以自行研究下~至此,调试web项目就到这了,下面我们来看一下怎样用此debugger科学的看那些库源码

源码调试

正如背景里面所提到的,在未接触VS Code的debugger之前,我看源码的过程真的很苦逼...而且时常搞不清源码中各个函数的调用栈顺序,效率着实慢的着急,由此往往没耐心往下看,也体会不到源码里的思想精髓...

废话不多说,这节我们以rollup源码为例。建议花半分钟可以去官网看看这是个什么,不过看不看无所谓也不是这节的重点。建议把此项目clone下来跟着步骤一起走。

打开项目,发现整块源码都是用TypeScript写的(实践你会发现在VS Code中用debugger配合TypeScript看源码有多爽),VS Code可以调试任何可以编译成javascript的语言,更不用说亲儿子TS了。

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第14张图片

看到项目目录中是有自己的.vscode目录中,打开看下launch.json是有关于debug test的配置的,我们先点右下角添加一个Node.js: Launch配置,先放在这。然后看下package.json文件的scripts字段下的命令,在背景里面也说了在install完成后会执行build脚本,我们可以看看build中有一段rollup -c命令,这个命令就是典型的rollup打包命令,也就是说它以上一版本已经打包后的自已为依赖把自己的源码进行了打包,那我们就去看下rollup.config.js文件(-c 是指根据根目录下的rollup.config.js文件进行配置打包)。

打开rollup.config.js文件,主要是这三项配置:

/* Rollup core node builds */
{
    input: 'src/node-entry.ts',
    ...,
    output: [
        { file: 'dist/rollup.js', format: 'cjs', sourcemap: true, banner },
        { file: 'dist/rollup.es.js', format: 'esm', banner }
    ]
},
/* Rollup CLI */
{
    input: 'bin/src/index.ts',
    ...,
    output: {
        file: 'bin/rollup',
        format: 'cjs',
        banner: '#!/usr/bin/env node',
        paths: {
            rollup: '../dist/rollup.js'
        }
    }
}
/* Rollup core browser builds */
{
    input: 'src/browser-entry.ts',
    ...,
    output: [
        { file: 'dist/rollup.browser.js', format: 'umd', name: 'rollup', banner },
        { file: 'dist/rollup.browser.es.js', format: 'esm', banner }
    ]
}

这是根据input文件打包到output的输出路径,可以看看package.json里面的files字段就对应与这里的output的输出路径,也就是最终发布到npm包里的所有代码。我们先从Rollup CLI打包过程看起,它的input输入文件是 bin/src/index.ts,这里的入口文件应该就是rollup -c对应的执行源文件了,我们先在const command = minimist(...)这行打个断点。

既然bin/src/index.ts是最开始的rollup -c开始的执行源文件,那我们将此添加至刚刚在launch.json新添加的配置里

{
    "type": "node",
    "request": "launch",
    "name": "Launch Program",
    "program": "${workspaceFolder}/bin/src/index.ts",  // 更换这里的路径
    "args": ["-c"]  // 传给program的参数
}

注意我们加➕了个args字段,这样就模拟了rollup -c命令,这时候若是按F5启动debug,会报个错
无法启动程序.../src/index.ts,提示设置"outFiles"属性

就是说我们是以ts文件为入口的文件,VS Code需要编译后的js文件对源ts文件的映射,也就是需要sourcemap文件的路径,这样才能对应与源码的位置,可是我们看到只有dist目录下的rollup.js文件有对应的sourcemap文件,这从上面的三项配置就可以看到只有Rollup core node builds下的output下的file: 'dist/rollup.js',设置了sourcemap: true,那我们给Rollup CLI也设置一下:

/* Rollup CLI */
{
    input: 'bin/src/index.ts',
    ...,
    output: {
        file: 'bin/rollup',
        format: 'cjs',
        banner: '#!/usr/bin/env node',
        paths: {
            rollup: '../dist/rollup.js'
        },
        sourcemap: true    // 设置sourcemap
    }
}

这样给launch.json也要设置对应的 outFiles 属性outFiles: ["${workspaceFolder}/bin/*"], 这样就能找到源文件的映射了。

我们改了rollup.config.js文件,那就意味着需要重新 run build 一下,在命令行执行npm run build,可以看到bin目录下有了新的rollup.map文件

然后F5启动debug,你会发现程序停在最开始打的command断点那个地方了,这样你就可以寻着debug的脚步 探寻源码之旅了,大功告成!

彩蛋


上面的源码调试虽然成功了,可是它调试的是原有的npm run build命令,也就是仓库自己的一些rollup配置,我想调试自己写的一些rollup配置该咋办勒。。。?

其实前面的背景已经提到了这个问题,在clone的rollup目录下执行npm link,然后你在你自己写的rollup配置目录里执行npm link rollup,这样你在node_modules(先安装好rollup依赖的其他依赖,可以先npm install rollup,然后删除node_modules里的rollup仓库,link你clone的rollup)里就可以看到整个rollup的链接仓库,在链接仓库里打断点,然后在按上面的步骤在你的例子项目里配置launch.json,这样启动你的debug,你会发现打的断点没用... ,程序没有暂停过,这也是因为node_modules里的是symlinks,要使断点起作用的话,得给launch.json加上运行参数:

{
    "runtimeArgs": [
        "--preserve-symlinks",
        // "--preserve-symlinks-main"
    ]
}

如果你的program指向的也是个链接文件就也要加上"--preserve-symlinks-main"参数,这样就能正常调试你自己写的配置了。(需要Node.js 10+)


在你调试的过程中进行单步调试的时候时常会进入一些node_modules里不想看的库,或者会进入到node的内置模块里,这些其实有时候没必要看,我们就可以跳过这些文件,例如:

{
    "skipFiles": [
        "${workspaceFolder}/node_modules/**/*.js",
        "${workspaceFolder}/lib/**/*.js",
        "/**/*.js"   // node内部核心模块 设置的话在正常调试的时候可能有些问题。。。
    ]
}

在前面调试源码一节中我们修改了rollup源码的配置文件并重新手动 run build 了一下,其实我们可以直接在launch.json配置文件中配置一个"preLaunchTask": "rollup",它表示在启动debug调试之前运行一个任务,可以在.vscode文件夹下新建一个task.json,针对源码调试那节我们可以写如下配置:

{
    // See https://go.microsoft.com/fwlink/?LinkId=733558
    // for the documentation about the tasks.json format
    "version": "2.0.0",
    "tasks": [
        {
            "label": "rollup",
            "type": "shell",
            "command": "npm run build"
        }
    ]
}

然后在launch.json中配置"preLaunchTask": "rollup",这样,我们就不用在debug之前手动去执行build,直接F5启动debug就行。相应的还有postDebugTask钩子在debug结束后执行一些任务,关于任务的具体设置信息可以看这里


end

作者 @cslove
本文版权属于再惠研发团队,欢迎转载,转载请保留出处。

目录

断点调试

1. 简介

2. 打断点

3. 开始调试

4. 单步前进 - Step Into

5. 继续单步前进-研究循环

6. continue, while

7. Step Out, Step Over


1. 简介

在程序有BUG/缺陷,需要修复时,断点调试是发现缺陷的重要方法。对于初学者而言,断点调试还有另外一个用途:帮助理解程序背后的逻辑。

本文以下述程序为例,讲述在Visual Studio Code中的断点调试方法。

names = ['Peter Anderson', 'Frank Bush', 'Tom Henry','Jack Lee', 'Dorothy Henry']

sName = "NOTFOUND"
for x in names:
    if x.endswith("Henry"):
        sName = x
        break
    print(x, "not ends with 'Henry'.")

print("I found a Henry:", sName)

2. 打断点

在Visual Studio Code中打开相关代码文件,用鼠标在行号3的左方空白处单击(下图红点处),便会出现红色的断点-breakpoint。如果在相同位置再次单击,断点便会消失。在同一个程序中,断点可以打很多个。

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第15张图片

3. 开始调试

选择Debug->Start Debugging菜单项,或者直接按下F5快捷键(使用笔记本的读者注意:F5键可能同时复用了其它功能,需要配合Fn键使用);

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第16张图片

然后在弹出的菜单里选择Python File / Debug the currently active Python file;

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第17张图片

调试过程启动,程序开始运行,然后遇到了第3行的断点,停了下来。请读者注意,当前第3行是黄色高亮的,这说明程序执行完了1-2行,第3行处于等待执行状态。

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第18张图片

上图的左方,VARIABLES/变量栏则列出了全部的LOCAL/局部变量。可以看到,作为第1行代码的执行结果,名字为names的变量存在,其值为一个列表。因为第3行代码尚未执行, 所以目前sName变量尚不存在。

4. 单步前进 - Step Into

在前图的上方,有一个工具栏,其中,第三个按钮(方向向下的键头)的弹出标签为Step Into(F11)。这个按键的作用为单步前行。按一下这个按键,或者直接按F11,会发现程序向前执行了一行,第4行变为高亮待执行。作为第3行代码的执行结果,sName变量出现在左方VARIABLES栏中。如果把鼠标移至代码中的sName上方,Visual Studio Code还会显示sName变量的当前值为NOTFOUND。如下图:

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第19张图片

5. 继续单步前进-研究循环

再次点击Step Into, 第4行被执行,第5行变为高亮待执行。请读者注意,根据for循环, x变量取值names列表的第1个元素,其值为'Peter Anderson'。

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第20张图片

显然,第5行的逻辑判断不成立,第6,7行不会被执行。再次按下Step Into后,第8行高亮待执行:

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第21张图片

Step Into执行第8行,下方控制台会输出相应的print结果,然后程序执行点回到了第4行,准备开始下一轮循环:

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第22张图片

再次Step Into后,第5行高亮待执行。此时,x取值names列表的第2个元素,其值为'Frank Bush':

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第23张图片

同样,Frank Bush也不是Henry,第5行的逻辑判断不成立,6,7不执行,第8行执行 ... 按Step Into两次,程序重新回到第4行,准备开始第三轮循环:

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第24张图片

再次按下Step Into, 第5行高亮待执行。此时,x取值names列表的第3个元素,其值为'Tom Henry'。请注意,VARIABLES栏中x变量的值。

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第25张图片

这一次不一样了,x以"Henry"结尾,所以第5行的逻辑判断成立,再次按下Step Into,程序来到了第6行:

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第26张图片

Step Into执行完第6行后,sName的值从'NOTFOUND'变成了'Tom Henry',程序停在了第7行:

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第27张图片

按照语义,break语句执行将导致循环直接结束,第8行不会执行,剩下的names列表中的'Jack Lee', 'Dorothy Henry'会被忽略,程序直接来到第9行。由于第9行是空行, Visual Studio Code直接来到第10行。请读者注意,根据缩进规则,第10行与第4行的for循环属于同一层级,不属于循环体内部代码。

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第28张图片

再次Step Into, 第10行执行结束,下方控制台打印了“I found a Henry: Tom Henry。程序调试自动结束:

[从零开发JS应用] 如何在VScode中配置Javascript环境,常见的调试方法有哪些?_第29张图片

6. continue, while

希望上述调试过程可以帮助读者理解for循环及break语句。

如果读者对continue, while循环等感到疑惑,也可以对相关代码进行调试研究。

7. Step Out, Step Over

Visual Studio Code的调试工具栏内,还有Step Out, Step Over等按钮。不同于Step Into(单步前进), Step Out, Step Over用于在调试过程中避免过分深入函数或者循环内部。

本文节选自作者的B站MOOC及同名教材:

Python编程基础及应用 — 重庆大学 高等教育出版社,作者亲授_哔哩哔哩 (゜-゜)つロ 干杯~-bilibili​www.bilibili.com/video/BV1kt411R7uW

作者:海洋饼干叔叔并包含指向本页面的链接。 Visual Studio Code中的Python程序断点调试 - 知乎

你可能感兴趣的:(javascript,开发语言,vscode,前端)