Node.js / 系统课时

配置 VS Code 开发环境

配置 VS Code 开发环境

这一节把 VS Code 配成可直接写、格式化、检查并调试 Node.js 的工作环境。完成后,保存 JavaScript 文件会自动格式化,集成终端能识别 Node 与 npm,按 F5 可以从项目目录启动入口文件并命中断点。

学习目标

  • 安装 Node.js 开发常用扩展,并用工作区设置固定格式化行为。
  • 用集成终端确认 Node、npm 与当前工作目录正确。
  • 建立可复用的 Node 调试配置,并验证断点和终端输出。

安装扩展并固定保存格式化

Node.js 的语法高亮、补全和基础语法诊断由 VS Code 内置的 JavaScript/TypeScript Language Features 提供。项目若要使用 ESLint 规则,再安装 ESLint 扩展;代码格式化可以使用 Prettier 扩展。先在项目根目录打开 VS Code 终端执行:

bash
code --install-extension dbaeumer.vscode-eslint --force
code --install-extension esbenp.prettier-vscode --force
code --list-extensions

预期输出至少包含下面两行;如果你还装了其他扩展,列表会有更多内容。

text
dbaeumer.vscode-eslint
esbenp.prettier-vscode

在项目中创建 .vscode/settings.json。下面的设置只把 Prettier 指定为 JavaScript 的默认格式化器,避免影响其他语言;source.fixAll.eslint 设为 explicit,表示保存时只在明确触发保存动作时应用可修复的 ESLint 规则。

json
{
  "editor.formatOnSave": true,
  "editor.tabSize": 2,
  "editor.insertSpaces": true,
  "files.eol": "\n",
  "[javascript]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": "explicit"
  }
}

这份设置保存后立即对当前工作区生效。ESLint 扩展只有在项目存在可用的 ESLint 配置时才会执行规则检查;没有 ESLint 配置时,VS Code 仍会继续提供 JavaScript 语法错误提示,不要把“扩展已安装”误认为“项目已经有 lint 规则”。

用集成终端确认 Node 环境

打开菜单“View → Terminal”,Windows/Linux 也可以使用 Ctrl + 反引号快捷键,macOS 使用 Control + 反引号。终端应继承当前 VS Code 工作区目录。依次检查 Node 版本、npm 版本和当前路径:

bash
node --version
npm --version
node -p "process.cwd()"

预期输出形态如下,实际版本号和路径会不同;<PATH> 应当就是你当前打开的项目根目录。

text
v<NODE_VERSION>
<NPM_VERSION>
<PATH>

如果 node 或 npm 提示“command not found”或“不是内部或外部命令”,先在系统终端确认 Node 是否安装成功,再完全退出并重新打开 VS Code,让新 PATH 被进程重新读取。若路径不对,用“File → Open Folder...”重新打开项目根目录,不要在父目录里直接开发。

建立 F5 调试入口

先创建 src/index.js,用固定输出作为最小调试目标:

js
function main() {
  const message = "debug-entry-ok";
  console.log(message);
}

main();

再创建 .vscode/launch.json。program 指向实际入口文件,console 使用集成终端,skipFiles 跳过 Node 内部模块,方便单步调试时把注意力留在自己的源码上。

json
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Run Node Entry",
      "type": "node",
      "request": "launch",
      "program": "${workspaceFolder}/src/index.js",
      "console": "integratedTerminal",
      "skipFiles": [
        "<node_internals>/**"
      ]
    }
  ]
}

把断点点在 console.log(message); 这一行,按 F5 并选择 “Run Node Entry”。程序应先停在断点;继续执行后,集成终端出现:

text
debug-entry-ok

如果 F5 报“Cannot find module”或找不到入口文件,优先检查 program 路径是否与真实目录一致。若项目入口不是 src/index.js,只改 program,不要为了适配调试器去移动业务文件。

检查配置是否真的生效

在任意 .js 文件中故意输入 const add=(a,b)=>a+b;,保存后应被 Prettier 改成带标准空格的格式。再输入明显的语法错误,例如 const = 1,VS Code 应立即出现红色诊断;修复后诊断消失。最后重新按 F5,确认断点和 debug-entry-ok 输出仍然正常。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置 VS Code 开发环境

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通