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 终端执行:
code --install-extension dbaeumer.vscode-eslint --force
code --install-extension esbenp.prettier-vscode --force
code --list-extensions预期输出至少包含下面两行;如果你还装了其他扩展,列表会有更多内容。
dbaeumer.vscode-eslint
esbenp.prettier-vscode在项目中创建 .vscode/settings.json。下面的设置只把 Prettier 指定为 JavaScript 的默认格式化器,避免影响其他语言;source.fixAll.eslint 设为 explicit,表示保存时只在明确触发保存动作时应用可修复的 ESLint 规则。
{
"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 版本和当前路径:
node --version
npm --version
node -p "process.cwd()"预期输出形态如下,实际版本号和路径会不同;<PATH> 应当就是你当前打开的项目根目录。
v<NODE_VERSION>
<NPM_VERSION>
<PATH>如果 node 或 npm 提示“command not found”或“不是内部或外部命令”,先在系统终端确认 Node 是否安装成功,再完全退出并重新打开 VS Code,让新 PATH 被进程重新读取。若路径不对,用“File → Open Folder...”重新打开项目根目录,不要在父目录里直接开发。
建立 F5 调试入口
先创建 src/index.js,用固定输出作为最小调试目标:
function main() {
const message = "debug-entry-ok";
console.log(message);
}
main();再创建 .vscode/launch.json。program 指向实际入口文件,console 使用集成终端,skipFiles 跳过 Node 内部模块,方便单步调试时把注意力留在自己的源码上。
{
"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”。程序应先停在断点;继续执行后,集成终端出现:
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 输出仍然正常。