温馨提示×

如何在Debian上配置Node.js开发环境

小樊
46
2025-10-06 14:57:16
栏目: 编程语言

如何在Debian上配置Node.js开发环境

1. 准备工作:更新系统包

在安装任何软件前,建议先更新系统的包列表和已安装的包,确保系统处于最新状态:

sudo apt update && sudo apt upgrade -y

2. 安装Node.js和npm

Node.js的安装主要有两种方式:通过NodeSource存储库安装(推荐,支持最新版本)和通过NVM(Node版本管理器)安装(适合需要多版本切换的场景)。

2.1 通过NodeSource存储库安装(推荐)

NodeSource提供了Debian兼容的Node.js存储库,可安装最新稳定版或指定版本:

  • 步骤1:添加NodeSource存储库
    以安装Node.js 18.x为例,运行以下命令(替换18.x为所需版本):

    curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
    

    该命令会自动添加NodeSource的APT存储库并导入GPG密钥。

  • 步骤2:安装Node.js和npm
    执行以下命令安装Node.js(包含npm):

    sudo apt install -y nodejs
    
  • 步骤3:验证安装
    安装完成后,通过以下命令检查版本:

    node -v  # 输出Node.js版本(如v18.16.0)
    npm -v   # 输出npm版本(如10.4.0)
    

    若显示版本号,则说明安装成功。

2.2 通过NVM(Node版本管理器)安装(适合多版本切换)

若需要同时使用多个Node.js版本(如开发时用最新版,生产用稳定版),推荐使用NVM:

  • 步骤1:安装NVM
    运行以下命令下载并安装NVM(以最新版本为例):

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
    

    安装完成后,关闭并重新打开终端,或运行source ~/.bashrc使NVM生效。

  • 步骤2:安装指定版本的Node.js
    使用NVM安装Node.js(如18.16.0):

    nvm install 18.16.0
    
  • 步骤3:切换Node.js版本
    通过以下命令切换版本(如切换到18.16.0):

    nvm use 18.16.0
    

    安装后,node -vnpm -v会显示当前使用的版本。

3. 配置环境变量(可选)

若通过NodeSource安装,Node.js和npm的路径通常已自动添加到系统PATH中。若需手动配置(如自定义安装路径),可编辑~/.bashrc文件:

nano ~/.bashrc

在文件末尾添加以下内容(替换为实际路径):

export PATH=$PATH:/usr/local/node-v18.16.0-linux-x64/bin

保存后运行source ~/.bashrc使配置生效。

4. 安装常用开发工具

  • 全局安装nodemon:用于自动重启Node.js应用(开发时必备),避免每次修改代码后手动重启:

    sudo npm install -g nodemon
    

    安装后,用nodemon server.js代替node server.js启动应用,修改代码后会自动重启。

  • 升级npm至最新版本:确保使用最新的包管理功能:

    sudo npm install -g npm@latest
    

5. 创建并运行第一个Node.js项目

  • 步骤1:初始化项目
    创建项目目录并初始化package.json(记录项目依赖和配置):

    mkdir my-node-app && cd my-node-app
    npm init -y
    
  • 步骤2:安装依赖
    以Express框架为例,安装Express(Web应用框架):

    npm install express
    
  • 步骤3:创建应用文件
    在项目根目录创建app.js,写入以下代码:

    const express = require('express');
    const app = express();
    const port = 3000;
    
    app.get('/', (req, res) => {
      res.send('Hello, Debian Node.js Development Environment!');
    });
    
    app.listen(port, () => {
      console.log(`Server running at http://localhost:${port}`);
    });
    
  • 步骤4:运行应用
    使用nodemon启动应用(或node app.js):

    nodemon app.js
    

    打开浏览器访问http://localhost:3000,若看到“Hello, Debian Node.js Development Environment!”,则说明环境配置成功。

6. 可选:配置PM2进程管理(生产环境推荐)

PM2是Node.js进程管理工具,可实现应用自动重启、负载均衡、日志管理等功能:

  • 全局安装PM2

    sudo npm install -g pm2
    
  • 启动应用
    在项目目录下运行:

    pm2 start app.js
    
  • 常用命令

    • pm2 list:查看运行中的应用列表;
    • pm2 logs:查看应用日志;
    • pm2 restart app:重启应用;
    • pm2 save:保存当前进程列表(防止重启服务器后进程丢失)。

通过以上步骤,你已在Debian系统上成功配置了Node.js开发环境,可开始编写、运行和调试Node.js应用。根据需求选择安装方式(NodeSource或NVM),并搭配常用工具(nodemon、PM2)提升开发效率。

0