腳本之家服務器常用軟件

快捷導航

教你從零開始在Windows系統(tǒng)上搭建一個node.js后端服務項目

更新時間：2024年11月09日 10:19:03 作者：梅禿頭

這篇文章詳細介紹了如何在Windows環(huán)境下搭建一個Node.js項目并使用Express框架,包括安裝Node.js、配置環(huán)境、創(chuàng)建項目、安裝Express、編輯代碼、運行項目、集成Nodemon實現(xiàn)熱部署等步驟

一、下載node.js及配置環(huán)境

網上很多安裝教程，此處就不再贅述了

版本信息

C:\Users\XXX>node -v
v20.15.0

C:\Users\XXX>npm -v
10.7.0

了解更多npm知識：npm 中文網 (nodejs.cn)

二、搭建node.js項目及安裝express框架

在任意位置創(chuàng)建一個項目文件夾，此處項目文件夾名為test（文件夾路徑：D:\test）

以管理員身份打開windows命令行工具或powershell命令行工具（記住：必須以管理員身份打開，不要使用win+R的方式或者文件夾輸入cmd的方式打開，否則后面安裝express會失?。?/p>

左下角搜索框輸入命令提示符，打開windows命令行工具（沒有安裝powershell，推薦使用這種方式）

打開powershell命令行工具（需要安裝好powershell才可以打開）

打開命令行，進入創(chuàng)建的test項目文件夾

創(chuàng)建package.json，命令行輸入下列命令

npm init

name 項目名稱
version 項目版本號
description 項目描述信息
entry point 項目入口文件
test command 項目啟動時腳本命令
git repository Git倉庫地址
keywords 關鍵詞
author 作者

一路回車鍵

創(chuàng)建test項目的文件夾出現(xiàn)了pakage.json文件，打開查看里面的信息

安裝express

npm install express --save

安裝完成，如果是以管理員身份打開的命令行一般不會報錯

安裝好了后出現(xiàn)下列兩個文件（夾）

package文件內容隨之改變，由于程序主入口是index.js，所以要創(chuàng)建index.js文件，（文件后綴必須是js）

編輯index.js文件內容，為了快速，我們直接找到express官網，打開里面的示例

Express - 基于 Node.js 平臺的 web 應用開發(fā)框架 - Express中文文檔 | Express中文網 (expressjs.com.cn)

package.json |npm 文檔 (npmjs.com)

復制Hello World示例到index.js文件中

修改下打印日志的內容

const express = require('express')
const app = express()
const port = 3000

app.get('/', (req, res) => {
  res.send('Hello World!')
})

app.listen(port, () => {
  console.log(`Example app listening on http://localhost:${port}`)
})

運行項目，輸入命令node 入口文件.js

咱這邊的入口文件是index.js，稍微修改下

node index.js

啟動成功后，瀏覽器訪問服務，輸入控制臺輸出的訪問地址：http://localhost:3000

到這，就成功了

為了方便后續(xù)管理代碼，新建一個名為src文件夾，將之前創(chuàng)建的index.js文件移入src中（index.js移動到src文件夾后，啟動時要進入index.js的上一級文件夾再進行啟動，D:\test\src> node index.js）

三、集成nodemon，實現(xiàn)代碼熱部署

不需要熱部署，可以不用跟著下面的步驟

安裝nodemon，命令行輸入：npm i nodemon -g

接下來開始實現(xiàn)熱部署，修改pakage.json文件，修改兩處：main入口文件和scripts對象

"main": "路徑從點擊進入項目的下一級開始，直到index.js文件"

{
  "name": "test",
  "version": "1.0.0",
  "description": "測試創(chuàng)建node項目",
  "main": "src/index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
	"start":"nodemon --watch src --watch config src/index.js"
  },
  "author": "小紅",
  "license": "ISC",
  "dependencies": {
    "express": "^4.21.1"
  }
}

輸入npm run start啟動項目，終止項目ctrl+C

熱部署的好處在于，不需要重啟項目，刷新瀏覽器即可完成代碼更新，如何判斷是否成功熱部署，一是命令行綠色部分執(zhí)行代碼，二是不重啟項目，修改index.js項目的內容，保存后刷新瀏覽器查看顯示內容是否變化，有變化則成功（修改端口則需要重啟服務）

四、Express 應用程序生成器

照舊，第一步創(chuàng)建項目文件夾，管理員身份進入命令行，創(chuàng)建pakage.json文件，執(zhí)行npm init

通過應用生成器工具 express-generator 可以快速創(chuàng)建一個應用的骨架。

你可以通過 npx （包含在 Node.js 8.2.0 及更高版本中）命令來運行 Express 應用程序生成器

npx express-generator

執(zhí)行完npx express-generator命令就可以快速生成以下項目結構文件

由于項目結構是使用生成器生成的，需要安裝項目內的依賴包，執(zhí)行一下npm install

打開app.js（原默認是index.js，沒有選擇直接回車，而是在后面輸入app.js后再回車，因此我的入口文件就改成了app.js），可以看到，文件內是沒有配置端口，以及啟動打印的數(shù)據(jù)的，在這里可以自行手動配置下（app.get()或app.set()需要在var app = express();后面使用）