使用VSCode开发Nodejs

本文介绍了如何使用Visual Studio Code(VSCode)来开发Node.js项目。通过创建项目文件夹ExpressApp并配置批处理文件,可以便捷地用VSCode打开Node.js项目。在VSCode中,可以通过在文件上右键打开命令提示符,或者利用调试面板和F5快捷键进行调试。虽然VSCode的智能提示功能相对于Visual Studio尚有不足,但它仍然是一个高效开发Node.js的工具。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

参考:https://code.visualstudio.com/Docs/runtimes/nodejs

   webstore是目前最受欢迎的Nodejs开发IDE之一。受欢迎的原因,当然是对于Nodejs IDE的集成开发环境,集项目创建、编辑、调试于一体,简单的配置,强大的智能提示。
   实际上使用Visual Studio开发Nodejs也不逊于WebStore,但是Visual Studio这种集成开发环境的软件过于庞大,电脑配置不好的话,多开启几个VS项目动不动就崩掉了或机器卡死。
   本文本介绍是Nodejs一种轻量级的开发工具——使用VSCode。尽管VScode看起来更像是Uedit、Noteplus等强大文件编辑器,但它也提供了可扩展的、强大的提示功能(特别是文件间js引用提示),以及内置Nodejs调试功能,让它有别于一般的编辑工具。
 
一、使用Express创建项目
1、全局安装Express
(如已安装忽略此步骤)
npm install -g express

2、创建项目

       创建项目(创建文件夹名称ExpressApp)

express ExpressApp

生成目录如下
ExpressApp
 |-- app.js
 |-- package.json
 |-- bin
     |-- www
 |-- public
     |-- images
     |-- javascripts
     |-- stylesheets
     |-- style.css
 |-- routes
     |-- index.js
     |-- users.js
 |-- views
     |-- error.jade
     |-- index.jade
     |-- users.jade


3、下载第三方包
(1)cmd命令行切换到项目目录
cd e:\nodejs\ExpressApp
(2)根据需要编辑package.json,运行如下指令安装第三方包
npm install
在项目目录下node_modules可见安装好的第三方包
ExpressApp 
 |-- node_modules 
(3)运行项目
npm start
输出如下:
  > ExpressApp@0.0.0 start E:\Nodejs_Workspace\ExpressApp
  > node ./bin/www
   注:npm start指令会自动执行node ./bin/www

在浏览器中输入http://localhost:3000,可访问Express欢迎页面



二、使用VSCode开发Nodejs
1、VSCode打开Nodejs
   code e:\nodejs\ExpressApp   
或
   cd e:\nodejs\ExpressApp
   code .

   注:在当前项目下创建ExpressApp.bat,输入“code .”即可,下次直接此文件直接使用VSCode打开Nodejs项目

@echo off
code.

   打开VsCode后,在左侧导航栏上的任意文件上右键,可以快捷打开CMD命令,也可以打开文件所在文件夹。


2、添加智能提示

   VSCode打开Nodejs项目,默认是没有智能提示。
(1)使用TypeScript Definition Manager(TSD)在项目中下载所需的tsd文件,VSCode中打开时有智能
         全局安装tsd(如已安装忽略)
npm install -g tsd
       下载所需的组件提示(以下载node、express提示为例)
tsd query node --action install
tsd query express --action install
  注:
①多个提示组件在query参数后可以空格分隔简写为tsd query node express --action install
②组件会项目目录下添加typings文件夹
 |-- typings
     |-- node
     |-- express

(2)添加js文件引用的智能提示
          假如在文件引用另外一个文件common.js时,文件头添加如下
/// <reference path="common.js"/>

(3)添加js标准智能提示
          在项目根目录下添加jsconfig.json文件,文件内容如下:
{
    "compilerOptions": {
        "target": "ES5",
        "module": "commonjs"
    }
}
    此配置表示代码服从ES5标准并使用commonjs规范(什么是commonjs请参考http://www.cnblogs.com/fullhouse/archive/2011/07/15/2107416.html),发VScode下有此配置之后,可以实现在文件中对require引用js文件的智能提示。(我测试时无此配置也会有智能提示,不清楚什么原因)

三、调试

1、创建VSCode调度配置文件

   点击调试面板,并点击运行(F5)按钮时,右侧出现下拉框,选择“Node.js”

   然后会在项目目录下创建launch.json文件
ExpressAppp
 |--.vscode
    |-- launch.json

   可根据需要编辑launch.json,修改启动配置项

2、创建断点:

      根据需要创建断点:在js文件编辑区域左侧,会添加/移除断点

3、调度

     在调试面板上点击运行或按快捷键F5


四、VSCode编辑js常用快捷方式


快捷键说明
F5调试运行程序
F8查看警告、错误信息
F12 快速定义到声明
Ctrl + P快捷查找文件(输入?显示所有指令)
Ctrl + F文件中快速查找
Ctrl + Btoggle左侧导航栏
Ctrl + Shift + M显示警告和错误,相当于Ctrl + P,输入!
Ctrl + Shift + O根据类型符号查找,相当于Ctrl + P,输入@:
  

五、VSCode的几个问题

        可能因为VsCode才出来半年左右,与VS强大的智能提示功能相比,还是差了不少。其中最影响使用的在于以下几点:

       1、不能识别(智能提示)构造函数内部声明的成员;
       2、js文件之间引用关系的智能提示没有(尽量添加了/// <reference path="" />)
       3、不支持js排版(尽管有预留了功能用快捷键 ctrl + shift + F用于排版,但功能未实现)


 
 

### 创建和配置新的 Node.js 项目 为了在 Visual Studio Code (VSCode) 中设置和启动一个新的 Node.js 项目,需遵循一系列具体的操作指南。 #### 安装必要的工具 确保已安装 Node.js 和 VSCode。可以从官方渠道获取这两个软件的最新版本并完成安装过程[^1]。一旦安装完毕,在 VSCode 内新建一个工作区来容纳即将创建的项目文件夹。 #### 初始化 Node.js 项目结构 通过命令行进入新建立的工作目录,并执行 `npm init` 或者更推荐使用 `pnpm init` 来初始化 package.json 文件。这一步骤会引导用户输入一些基本信息,比如项目的名称、描述以及入口脚本等。 #### 配置调试环境 对于希望利用内置调试功能的情况,在 `.vscode/launch.json` 文件中定义合适的配置项可以极大地方便开发者进行断点调试和其他开发活动。下面是一个典型的 launch.json 设置实例: ```json { "version": "0.2.0", "configurations": [ { "type": "node", "request": "launch", "name": "Launch Debug", "skipFiles": ["<node_internals>/**"], "program": "${workspaceFolder}/src/hello.ts", "outFiles": ["${workspaceFolder}/dist/**/*.js", "!**/node_modules/**"] } ] } ``` 此配置允许直接从源码(假设是以 TypeScript 编写的 hello.ts)开始调试应用,并跳过内部模块以提高效率[^2]。 #### 构建与打包 当准备发布应用程序时,可能需要用构建工具如 esbuild 将多个依赖关系压缩到单一可执行文件中。可以通过如下方式实现这一点: 首先添加 esbuild 到 devDependencies: ```bash pnpm add -D -E esbuild ``` 接着运行以下命令来进行实际的打包处理: ```bash pnpm esbuild src/hello.ts --bundle --platform=node --target=node18 --outfile=dist/main.js ``` 这条指令将会把所有的资源捆绑在一起形成 dist/main.js 这样的最终产物,适用于目标平台 node 版本为 18 的环境中。 #### 处理 HTTP 请求路径映射 如果遇到访问根 URL (`http://localhost:port/`) 返回 “Cannot GET /” 错误,则表明服务器端未正确设定响应首页的内容。应确保 Express 应用或其他框架中有适当的方法处理 `/` 路由请求,返回预期页面或消息[^3]。
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值