Loading... # Debian 下 Node.js 安装指南 # 一、概述 ## 1. 简介 ### A. 是什么 Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时环境，它使 JavaScript 可以在服务器端运行。npm (Node Package Manager) 是 Node.js 的默认包管理器，用于安装和管理 JavaScript 依赖包。 ### B. 为什么学 - 使用 JavaScript 进行全栈开发 - 丰富的 npm 生态系统 - 高性能的 I/O 处理能力 - 适合构建实时应用和 API 服务 ### C. 学完能做什么 - 运行 Node.js 应用程序 - 使用 npm 管理项目依赖 - 开发 Web 服务器和 API - 使用 nvm 管理多个 Node.js 版本 ## 2. 前置知识 ### A. 必备技能 - 基本 Linux 命令行操作 - 了解包管理器概念（apt、npm） ### B. 推荐知识 - JavaScript 基础语法 - 终端环境变量配置 # 二、环境准备 ## 1. 系统要求 - Linux：Debian 11+ / Ubuntu 18.04+ / CentOS 7+ - macOS：10.15+ - Windows：10/11 ## 2. 安装方式对比 | 安装方式 | 优点 | 缺点 | 推荐场景 | |---------|------|------|---------| | nvm (Node Version Manager) | 版本管理灵活、无需 sudo、多版本共存 | 需要额外工具 | ✅ 推荐，开发环境 | | NodeSource 仓库 | 官方源、版本较新 | 需要 sudo、权限限制 | 生产环境 | | 系统自带仓库 | 安装简单、版本稳定 | 版本较旧 | 测试环境 | ## 3. 安装步骤 ### 检查当前状态 ```bash node --version cat /etc/os-release ``` ### 使用 nvm 安装（推荐） 安装 nvm： ```bash unset NVM_DIR && curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash ``` ### 加载 nvm 环境变量 ```bash export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" ``` ### 安装 Node.js LTS 版本 ```bash nvm install --lts ``` ## 3. 验证安装 ```bash node --version npm --version ``` 预期输出： ``` v24.14.0 11.9.0 ``` # 三、核心概念 ## 1. 基本术语 - Node.js：JavaScript 运行时环境 - npm：Node Package Manager，包管理器 - LTS：Long Term Support，长期支持版本 - nvm：Node Version Manager，版本管理工具 ## 2. 工作原理 ```mermaid graph LR A[开发者] -->|编写 JS 代码| B[nvm] B -->|管理多个版本| C[Node.js] C -->|V8 引擎| D[执行 JS] B -->|npm| E[包管理] E -->|下载依赖| F[node_modules] F -->|导入使用| C ```  ## 3. 版本管理 ```mermaid graph TB subgraph Node.js 版本 A[LTS - 稳定版] B[Current - 最新版] end subgraph nvm 管理 C[nvm install --lts] D[nvm install latest] E[nvm use <version>] end A -.推荐.-> C B -.尝鲜.-> D C --> E D --> E E --> F[切换成功] ```  # 四、快速上手 ## 1. Hello World 示例 创建 test.js： ```javascript console.log('Hello, Node.js!'); ``` 运行： ```bash node test.js ``` ## 2. 使用 npm 初始化项目 ```bash mkdir myapp && cd myapp npm init -y npm install express ``` ## 3. 创建简单的 Web 服务器 ```javascript const http = require('http'); const server = http.createServer((req, res) => { res.writeHead(200, { 'Content-Type': 'text/plain' }); res.end('Hello World\n'); }); server.listen(3000); ``` # 五、nvm 高级用法 ## 1. 常用命令 ```bash nvm ls # 列出已安装版本 nvm install 18.20.0 # 安装特定版本 nvm use 18.20.0 # 切换到指定版本 nvm alias default 18.20.0 # 设置默认版本 nvm uninstall 18.20.0 # 卸载版本 nvm current # 显示当前版本 ``` ## 2. 版本切换场景 不同项目可能需要不同 Node.js 版本，使用 nvm 可以轻松切换： ```bash cd project-a nvm use 18 cd project-b nvm use 20 ``` ## 3. 使用 .nvmrc 文件 在项目根目录创建 .nvmrc 文件指定版本： ``` 18.20.0 ``` 自动切换： ```bash nvm use ``` # 六、常见问题 ## 1. 安装问题 ### 问题：NVM_DIR 环境变量冲突 现象： ``` You have $NVM_DIR set to "/home/user/.config/nvm", but that directory does not exist. ``` 解决： ```bash unset NVM_DIR && curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash ``` ### 问题：命令未找到 现象：`nvm: command not found` 解决：关闭终端重新打开，或手动加载： ```bash source ~/.bashrc ``` ## 2. 权限问题 ### 问题：apt 安装需要 sudo 解决：使用 nvm 安装，无需 sudo 权限 ## 3. 网络问题 ### 问题：下载缓慢 解决：使用国内镜像源 设置 npm 镜像： ```bash npm config set registry https://registry.npmmirror.com ``` # 七、最佳实践 ## 1. 版本选择 - 开发环境：使用 Current 版本体验新特性 - 生产环境：使用 LTS 版本保证稳定性 ## 2. 项目管理 - 为每个项目指定 .nvmrc 文件 - 使用 package.json 管理依赖版本 - 定期更新依赖包 ## 3. 性能优化 - 使用 nvm 缓存加速安装 - 清理无用版本释放空间 ```bash nvm uninstall <version> ``` *** ## 参考资料 1. [Node.js 官方文档](https://nodejs.org/docs/) 2. [nvm GitHub 仓库](https://github.com/nvm-sh/nvm) 3. [npm 官方文档](https://docs.npmjs.com/) 最后修改：2026 年 03 月 09 日 © 允许规范转载 赞 如果觉得我的文章对你有用，请随意赞赏