Skip to content

第2章:开发环境搭建

2.1 不同系统Node.js安装

Windows系统安装

  1. 访问Node.js官网https://nodejs.org/
  2. 下载安装包:选择 LTS 版本的 Windows 安装包(.msi 文件)
  3. 运行安装程序:双击下载的 .msi 文件,按照提示完成安装
  4. 验证安装:安装完成后,打开命令提示符,输入 node -vnpm -v 查看版本

Mac系统安装

方法1:使用安装包

  1. 访问Node.js官网:https://nodejs.org/
  2. 下载 LTS 版本的 Mac 安装包(.pkg 文件)
  3. 双击下载的 .pkg 文件,按照提示完成安装
  4. 打开终端,输入 node -vnpm -v 查看版本

方法2:使用 Homebrew

  1. 打开终端,执行 brew install node
  2. 安装完成后,输入 node -vnpm -v 查看版本

Linux系统安装

Ubuntu/Debian系统

  1. 打开终端,执行以下命令:
    bash
    curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
    sudo apt-get install -y nodejs
  2. 安装完成后,输入 node -vnpm -v 查看版本

CentOS/RHEL系统

  1. 打开终端,执行以下命令:
    bash
    curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
    sudo yum install -y nodejs
  2. 安装完成后,输入 node -vnpm -v 查看版本

2.2 版本选择

  • LTS版本:长期支持版,稳定可靠,适合生产环境和新手学习
  • 最新版:包含最新特性,但可能不够稳定

推荐:新手建议使用 LTS 版本,确保稳定性和兼容性

2.3 安装验证

安装完成后,打开命令行工具,执行以下命令验证安装是否成功:

bash
# 查看 Node.js 版本
node -v

# 查看 npm 版本
npm -v

如果能看到版本号,说明安装成功。

2.4 开发工具准备

VS Code 安装

  1. 访问 VS Code 官网:https://code.visualstudio.com/
  2. 下载适合自己系统的安装包
  3. 按照提示完成安装

必备插件

安装 VS Code 后,建议安装以下插件:

  • Node.js Extension Pack:Node.js 开发必备插件集合
  • ESLint:代码质量检查
  • Prettier:代码格式化
  • JavaScript (ES6) code snippets:ES6 代码片段
  • Path Intellisense:路径自动补全

2.5 命令行基础

常用命令

命令功能
cd切换目录
ls (Mac/Linux) 或 dir (Windows)列出目录内容
mkdir创建目录
rm删除文件
rm -r删除目录
cp复制文件
mv移动文件
pwd显示当前目录
clear清空终端

路径操作

  • 绝对路径:从根目录开始的完整路径,如 C:\Users\Username (Windows) 或 /home/username (Mac/Linux)
  • 相对路径:相对于当前目录的路径,如 ./file.js(当前目录)或 ../parent/file.js(父目录)

快捷键

  • Ctrl + C:终止当前命令
  • Tab:自动补全命令或路径
  • 方向键上/下:查看历史命令

2.6 npm 入门

npm (Node Package Manager) 是 Node.js 自带的包管理工具,用于安装、卸载和管理第三方包。

常用 npm 命令

  • npm init:初始化项目,生成 package.json 文件
  • npm install <package>:安装指定包
  • npm install -g <package>:全局安装指定包
  • npm uninstall <package>:卸载指定包
  • npm update <package>:更新指定包
  • npm run <script>:执行 package.json 中定义的脚本

2.7 常见安装问题排查

安装失败

  • 网络问题:检查网络连接,尝试使用国内镜像
  • 权限问题:以管理员身份运行安装程序
  • 系统兼容性:确保下载的安装包与系统匹配

命令无法识别

  • 环境变量问题:检查 Node.js 是否添加到系统环境变量
  • 路径问题:确保 Node.js 安装路径正确

版本冲突

  • 多个版本:使用 nvm (Node Version Manager) 管理多个 Node.js 版本
  • 清理缓存:执行 npm cache clean --force 清理 npm 缓存

小结

  • Node.js 可以在 Windows、Mac、Linux 等系统上安装
  • 新手建议使用 LTS 版本,确保稳定性
  • 安装完成后需要验证 Node.js 和 npm 的版本
  • VS Code 是 Node.js 开发的推荐工具
  • 了解基本的命令行操作和 npm 命令
  • 遇到安装问题时,按照常见问题排查方法解决

现在,你已经成功搭建了 Node.js 开发环境,接下来让我们开始学习 Node.js 的核心基础。

© 2026 编程马·菜鸟教程 版权所有