搭建你的第一个Node.js开发环境

反正我还没长大

于 2025-06-26 15:03:58 发布

阅读量1k

点赞数 21

CC 4.0 BY-SA版权

分类专栏： Nodejs 文章标签： node.js

本文链接：https://blog.csdn.net/m0_75220683/article/details/148925740

Nodejs 专栏收录该内容

15 篇文章

订阅专栏

上篇文章我们聊了Node.js是什么，今天我们来动手搭建开发环境。

别担心，我会把每个步骤都说得很详细，就算你是完全的新手也能跟着做。

为什么要搭建开发环境？

想象一下，你要学做菜：

你需要一个厨房（开发环境）
需要各种工具：刀、锅、碗（编辑器、Node.js、包管理器）
需要食材（代码库、npm包）

没有这些基础设施，就没法开始做菜。开发也是一样。

需要安装什么？

我们需要准备这几样东西：

Node.js - 核心引擎，让JavaScript在服务器上运行
npm - 包管理器，用来下载和管理第三方库（装Node.js时会自动安装）
代码编辑器 - 写代码的工具，推荐VS Code
命令行工具 - 用来运行Node.js程序

别被这个清单吓到，其实很简单！

第一步：安装Node.js

Windows用户：

打开Node.js官网
- 在浏览器输入：https://nodejs.org
- 你会看到两个下载按钮，选择左边的"LTS"版本（长期支持版，更稳定）
下载安装包
- 点击下载，会得到一个.msi文件
- 文件名类似：node-v18.17.0-x64.msi
安装
- 双击下载的文件
- 一路点"下一步"就行，保持默认设置
- 安装过程中会问你是否添加到PATH，选择"是"

Mac用户：

方法一：官网下载

同样去 https://nodejs.org
下载.pkg文件
双击安装，一路下一步

方法二：用Homebrew（推荐）
如果你装了Homebrew：

brew install node

Linux用户：

Ubuntu/Debian：

sudo apt update
sudo apt install nodejs npm

CentOS/RHEL：

sudo yum install nodejs npm

第二步：验证安装

安装完成后，我们要确认一下是否安装成功。

打开命令行工具

Windows：

按Win + R，输入cmd，回车
或者按Win + X，选择"Windows PowerShell"

Mac：

按Cmd + 空格，输入"Terminal"，回车
或者在应用程序 → 实用工具 → 终端

Linux：

按Ctrl + Alt + T
或者在应用程序中找到"终端"

检查Node.js版本

在命令行输入：

node --version

如果看到类似v18.17.0的输出，说明Node.js安装成功了！

检查npm版本

在命令行输入：

npm --version

如果看到类似9.6.7的输出，说明npm也安装成功了！

如果出现"命令不存在"的错误：

重启电脑试试
检查PATH环境变量是否配置正确

第三步：安装代码编辑器

虽然用记事本也能写代码，但专业的编辑器能让你事半功倍。

VS Code必装插件

安装完VS Code后，建议安装这几个插件：

Chinese (Simplified) Language Pack - 中文界面
Node.js Extension Pack - Node.js开发套件
Prettier - 代码格式化工具
ES6 String HTML - 更好的JavaScript支持

怎么安装插件？

打开VS Code
点击左侧的扩展图标（四个方块）
搜索插件名称
点击"安装"

第四步：创建你的第一个项目

现在我们来创建第一个Node.js项目！

创建项目文件夹

选个地方放项目
比如在桌面创建一个文件夹叫my-first-node-app
用命令行进入文件夹
```
cd Desktop/my-first-node-app
```
小贴士： 如果不熟悉命令行，也可以在文件夹里右键，选择"在此处打开命令行"

初始化npm项目

在项目文件夹里运行：

npm init

它会问你一堆问题：

package name: 直接回车（用默认名称）
version: 直接回车
description: 可以写"我的第一个Node.js项目"
entry point: 直接回车
test command: 直接回车
git repository: 直接回车
keywords: 直接回车
author: 写你的名字
license: 直接回车

最后输入yes确认。

这一步做了什么？
创建了一个package.json文件，这是Node.js项目的"身份证"，记录了项目的基本信息。

创建第一个文件

用VS Code打开项目文件夹：

code .

在VS Code里创建一个新文件叫app.js，写入：

console.log('恭喜！你的第一个Node.js程序运行了！');

运行程序

在命令行输入：

node app.js

如果看到"恭喜！你的第一个Node.js程序运行了！"，说明一切都设置好了！

第五步：让开发更高效的工具

nodemon - 自动重启工具

每次修改代码都要手动重启很麻烦，nodemon可以自动帮你重启。

安装nodemon：

npm install -g nodemon

使用方法：
以后运行程序用：

nodemon app.js

现在修改代码保存后，程序会自动重启！

配置package.json的scripts

打开package.json，找到"scripts"部分，改成：

{
  "scripts": {
    "start": "node app.js",
    "dev": "nodemon app.js",
    "test": "echo \"Error: no test specified\" && exit 1"
  }
}

现在你可以用：

npm start - 正常启动
npm run dev - 开发模式启动（自动重启）

常见问题解决

问题1：npm安装很慢

解决方案： 使用国内镜像源

npm config set registry https://registry.npmmirror.com

问题2：权限错误（Mac/Linux）

如果npm安装时提示权限错误，在命令前加sudo：

sudo npm install -g nodemon

问题3：命令行不认识node命令

可能原因：

PATH环境变量没配置好
需要重启电脑
安装时没选择"添加到PATH"

解决方案：
重新安装Node.js，确保选择"添加到PATH"选项。

问题4：VS Code打不开项目

确保在项目文件夹里运行code .命令，注意有个点。

开发环境小贴士

1. 项目结构建议

my-project/
├── package.json      # 项目配置文件
├── app.js           # 主程序文件
├── node_modules/    # 第三方库（自动生成）
├── public/          # 静态文件（图片、CSS等）
└── views/           # 模板文件

2. 好用的VS Code快捷键

`Ctrl + `` （反引号）：打开集成终端
Ctrl + Shift + P：命令面板
Ctrl + /：注释/取消注释
Alt + Shift + F：格式化代码

3. npm常用命令

npm install package-name    # 安装包
npm install -g package-name # 全局安装包
npm uninstall package-name  # 卸载包
npm list                   # 查看已安装的包
npm outdated              # 查看过时的包

验证环境搭建

让我们用一个稍微复杂点的例子验证环境：

创建一个server.js文件：

const http = require('http');

const server = http.createServer((req, res) => {
  res.writeHead(200, {'Content-Type': 'text/html; charset=utf-8'});
  res.end(`
    <h1>🎉 恭喜！</h1>
    <p>你的Node.js开发环境搭建成功了！</p>
    <p>当前时间：${new Date().toLocaleString()}</p>
  `);
});

const PORT = 3000;
server.listen(PORT, () => {
  console.log(`服务器运行在 http://localhost:${PORT}`);
  console.log('按 Ctrl+C 停止服务器');
});