VS Code配置与调试

好马配好鞍,Node.js开发怎么能少得了VS Code?这东西是真的香,免费开源不说,插件生态强大到没朋友。这节课手把手教你配置一个完美的Node.js开发环境。

一、 下载安装VS Code

去官网 https://code.visualstudio.com/ 下载对应系统的版本。Windows用户直接运行安装包,Mac用户拖拽到Applications文件夹就行。

二、 必装插件

打开VS Code,点击左侧Extensions图标(或者按Ctrl+Shift+X),搜索安装这几个插件:

1. Node.js Extension Pack(强烈推荐)

这个打包了Node.js开发必备的所有插件:

2. Chinese (Simplified) Language Pack

中文语言包,看英文累的话必装!

3. Prettier - Code formatter

代码格式化工具,一键排版,拯救强迫症。

4. Thunder Client

在VS Code里直接测试API接口,不用切换到Postman了。

5. Auto Rename Tag

改HTML标签时自动成对修改,效率神器。

三、 必知快捷键

调试相关

代码编辑

文件操作

四、 配置settings.json

按 Ctrl+Shift+P,输入 "settings.json" 选择 "Open Settings (JSON)",添加这些配置:

{ // 统一用空格缩进,2个空格 "editor.tabSize": 2, "editor.insertSpaces": true,

// 保存时自动格式化 "editor.formatOnSave": true,

// 开启文件自动保存 "files.autoSave": "afterDelay",

// 不显示这些文件的预览 "files.exclude": { "/node_modules": true, "/.git": true },

// Node.js调试配置 "node.debug.maxTraceLength": 20000 }

五、 调试Node.js程序

这才是重点!学会调试,bug无处遁形。

方法1:直接调试

  1. 打开你的JS文件
  2. 在想停下的地方按F9设置断点(会显示红点)
  3. 按F5,选择 "Node.js"
  4. 程序会在断点处停下,你可以:
    • 查看变量值
    • 查看调用栈
    • 单步执行

方法2:Attach调试

Attach到正在运行的Node.js进程:

// 启动时加参数 node --inspect app.js

然后在VS Code里:

  1. 按F5
  2. 选择 "Attach to Node process"
  3. 找到你的进程,点连接

launch.json配置

点击左侧的调试图标(虫子图标),点击 "create a launch.json file",会生成一个 .vscode/launch.json 文件。改成这样:

{ "version": "0.2.0", "configurations": [ { "type": "node", "request": "launch", "name": "启动程序", "skipFiles": ["/"], "program": "${workspaceFolder}/app.js", "console": "integratedTerminal" }, { "type": "node", "request": "attach", "name": "附加到进程", "port": 9229, "restart": true, "skipFiles": ["/"] } ] }

六、 终端配置

VS Code内置终端很好用:

Windows用PowerShell

默认是cmd,可以改成PowerShell,更强大:

  1. Ctrl+Shift+P
  2. 输入 "Terminal: Select Default Shell"
  3. 选择 "PowerShell"

常用终端快捷键

七、 集成npm脚本

package.json里的scripts可以直接运行:

  1. 打开 package.json
  2. 看到上面的 "Run Script" 按钮了吗?
  3. 点一下就能看到所有npm脚本
  4. 右键可以运行

或者:

八、 ESLint配置

代码规范很重要,装完ESLint插件后:

初始化ESLint配置

npx eslint --init

会问你一些问题:

.eslintrc.json 示例

{ "env": { "node": true, "es2021": true }, "extends": "eslint:recommended", "parserOptions": { "ecmaVersion": 12 }, "rules": { "indent": ["error", 2], "linebreak-style": ["error", "unix"], "quotes": ["error", "single"], "semi": ["error", "always"] } }

保存文件时会自动检查,有问题的代码会有红色波浪线。

九、 常见问题

1. 终端显示乱码

在settings.json里加:

"terminal.integrated.defaultProfile.windows": "PowerShell", "terminal.integrated.env.windows": { "CHCP": 65001 }

2. 模块找不到

可能是没装依赖:

npm install

或者在终端运行:

npm install 模块名 --save

3. 调试时断点不生效

确认launch.json的program路径对不对:

"program": "${workspaceFolder}/app.js"

4. 代码提示不全

检查一下是否正确安装了类型定义:

npm install @types/node --save-dev

十、 总结

VS Code配置好,开发效率翻倍提升。这节课的核心:

下节课我们聊聊REPL交互环境,那是Node.js独有的神器!

有问题评论区见!