Debian Node.js如何安装配置

Debian系统安装配置Node.js指南

一、基础安装：使用APT包管理器（适合新手）

1. 更新系统包列表：确保系统软件包信息最新

   sudo apt update
   

2. 安装Node.js及npm：
   Debian默认仓库中的Node.js为较旧版本（如LTS版），执行以下命令安装：

   sudo apt install -y nodejs npm
   

3. 验证安装：
   安装完成后，通过以下命令检查版本（需显示版本号即为成功）：

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

二、推荐安装：使用NodeSource仓库（获取最新稳定版）

若需要安装最新稳定版或特定版本的Node.js，推荐使用NodeSource提供的APT仓库：

1. 添加NodeSource仓库：
   以安装Node.js 18.x为例，执行以下命令（替换18.x为目标版本）：

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

2. 安装Node.js：
   添加仓库后，通过APT安装：

   sudo apt install -y nodejs
   

3. 验证安装：
   同基础安装步骤，使用node -v和npm -v确认版本。

三、高级管理：使用NVM切换多版本（适合开发调试）

若需要同时管理多个Node.js版本（如项目依赖不同版本），推荐使用NVM（Node Version Manager）：

1. 安装NVM：
   执行以下命令安装最新版NVM：

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

2. 加载NVM配置：
   安装完成后，重新加载shell配置（如.bashrc）：

   source ~/.bashrc
   

3. 安装指定版本：
   列出可用版本（nvm ls-remote），选择目标版本安装（如16.20.2）：

   nvm install 16.20.2
   

4. 切换版本：
   使用nvm use命令切换版本（如切换到16.20.2）：

   nvm use 16.20.2
   

5. 设置默认版本：
   将常用版本设为默认（避免每次重启终端重新切换）：

   nvm alias default 16.20.2
   

四、配置环境变量（可选，解决路径问题）

若安装后无法直接使用node或npm命令，需配置环境变量：

1. 编辑配置文件：
   打开用户目录下的.bashrc文件（或.zshrc，根据shell类型调整）：

   nano ~/.bashrc
   

2. 添加PATH路径：
   在文件末尾添加以下内容（根据实际安装路径调整，如/usr/bin为默认路径）：

   export PATH=$PATH:/usr/bin
   

3. 生效配置：
   保存文件后，执行以下命令使更改生效：

   source ~/.bashrc
   

五、项目环境变量配置（.env文件）

开发时，敏感信息（如数据库密码、API密钥）建议通过.env文件管理：

1. 安装dotenv库：
   在项目目录下安装dotenv库：

   npm install dotenv
   

2. 创建.env文件：
   在项目根目录下创建.env文件，添加环境变量（格式为KEY=VALUE）：

   PORT=3000
   DATABASE_URL=mongodb://localhost:27017/mydb
   API_KEY=your_api_key_here
   

3. 加载.env文件：
   在项目入口文件（如app.js）顶部添加以下代码：

   require('dotenv').config();
   

4. 使用变量：
   通过process.env访问变量（如process.env.PORT）。

以上步骤覆盖了Debian系统下Node.js的基础安装、版本管理及环境配置需求，可根据实际场景选择合适的方法。