Debian Nodejs如何安装模块

在 Debian 系统上安装 Node.js 模块（npm 包），常见做法如下，按使用场景从最推荐到特殊场景说明。

一、先确认 Node.js / npm 已安装

node -v
npm -v

如果没有安装，推荐方式（不要用 apt 直接装旧版本）：

✅ 推荐：使用 NodeSource（官方推荐）

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

20.x 可换成 18.x / 22.x 等 LTS 版本

二、安装 Node.js 模块（npm 包）

1️⃣ 在当前项目中安装（最常用 ✅）

npm install 模块名

例如：

npm install express

会生成：

node_modules/
package.json
package-lock.json

如果是开发依赖：

npm install jest --save-dev

2️⃣ 全局安装模块

npm install -g 模块名

例如：

npm install -g nodemon

⚠️ Debian 上全局安装有时需要权限：

sudo npm install -g 模块名

或（推荐）配置 npm 使用用户目录：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

三、使用 package.json 安装模块（推荐）

初始化项目

npm init -y

安装模块

npm install axios

以后别人只需：

npm install

即可安装全部依赖。

四、Debian 系统级安装（不推荐但可用）

Debian 官方仓库也有部分 Node 模块：

sudo apt install node-模块名

例如：

sudo apt install node-express

⚠️ 缺点：

版本非常旧
并不完整
不适合现代 Node 项目

五、常见问题

1️⃣ 权限问题（EACCES）

✅ 推荐方案：不要用 sudo npm

使用：

nvm
或 npm prefix 方案（见上文）

2️⃣ 使用 nvm（推荐给开发者 ✅）

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

然后：

nvm install 20
nvm use 20

之后安装模块完全不需要 sudo。

六、总结（推荐组合）

✅ 最佳实践

场景	推荐方式
开发	nvm + npm
服务器	NodeSource + npm
项目依赖	`npm install`
全局工具	`npm install -g`

如果你愿意，可以告诉我：

你是 桌面还是服务器
是 全局工具 还是 项目依赖
Debian 版本（11 / 12）

我可以给你一条最适合你环境的命令。