1. Node.js安装前的准备工作在开始安装Node.js之前我们需要先了解几个关键概念。Node.js是一个基于Chrome V8引擎的JavaScript运行时环境它让开发者能够在服务器端运行JavaScript代码。与浏览器中的JavaScript不同Node.js提供了访问文件系统、创建网络连接等能力这使得它成为构建后端服务的理想选择。1.1 系统要求检查首先确认你的操作系统是否符合Node.js的安装要求Windows 7及以上版本推荐Windows 10macOS 10.10及以上版本Linux各主流发行版如Ubuntu 16.04、CentOS 7等提示32位系统只能安装32位版本的Node.js而64位系统可以安装32位或64位版本。建议64位系统安装64位版本以获得更好的性能。1.2 版本选择策略Node.js主要有两种版本分支LTS长期支持版稳定可靠适合生产环境Current当前版包含最新特性适合尝鲜和开发测试对于大多数用户特别是初学者建议选择LTS版本。你可以在Node.js官网的下载页面看到明确的版本标识。2. Windows系统安装指南2.1 使用安装包安装访问Node.js官网(https://nodejs.org/)点击LTS版本的下载按钮运行下载的.msi安装包在安装向导中保持默认选项但注意以下关键点勾选Automatically install the necessary tools选项安装路径建议保持默认(C:\Program Files\nodejs)完成安装后打开命令提示符(cmd)验证安装node -v npm -v2.2 使用包管理器安装高级用户对于习惯使用包管理器的用户可以通过以下方式安装使用Chocolateychoco install nodejs使用Scoopscoop install nodejs注意使用包管理器安装时可能需要先安装相应的包管理器工具。3. macOS系统安装指南3.1 使用官方安装包从Node.js官网下载macOS安装包(.pkg)双击运行安装包按照向导完成安装验证安装node -v npm -v3.2 使用Homebrew安装对于开发人员更推荐使用Homebrew管理Node.js首先安装Homebrew如果尚未安装/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)安装Node.jsbrew install node验证安装并检查路径which node which npm4. Linux系统安装指南4.1 Ubuntu/Debian系统使用官方PPA源安装curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt-get install -y nodejs验证安装node --version npm --version4.2 CentOS/RHEL系统添加NodeSource仓库curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -安装Node.jssudo yum install -y nodejs4.3 使用nvm管理多版本对于需要切换不同Node.js版本的开发者推荐使用nvmNode Version Manager安装nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash重新加载shell配置source ~/.bashrc # 或 ~/.zshrc安装特定版本Node.jsnvm install 16.14.2切换版本nvm use 165. 安装后的配置与验证5.1 环境变量检查安装完成后确保Node.js和npm/npx可执行文件所在的目录已添加到系统PATH中。可以通过以下命令检查which node which npm在Windows上where node where npm5.2 镜像源配置针对国内用户由于网络原因国内用户可能需要配置淘宝镜像源设置npm registrynpm config set registry https://registry.npmmirror.com可选安装cnpm淘宝的npm客户端npm install -g cnpm --registryhttps://registry.npmmirror.com5.3 全局模块安装位置默认情况下全局安装的模块会放在系统目录。为避免权限问题可以更改全局安装位置创建专用目录mkdir ~/.npm-global配置npm使用该目录npm config set prefix ~/.npm-global将目录添加到PATH在~/.bashrc或~/.zshrc中添加export PATH~/.npm-global/bin:$PATH6. 常见问题排查6.1 安装后命令不可用如果输入node或npm命令提示command not found可能是安装过程中PATH配置失败需要重新打开终端在Windows上可能需要重启系统解决方案检查安装路径是否在PATH中尝试完全卸载后重新安装对于Linux/macOS检查shell配置文件(~/.bashrc, ~/.zshrc等)6.2 权限问题在Linux/macOS上避免使用sudo安装全局模块这会导致权限问题。推荐使用nvm或修改npm全局安装目录。6.3 版本冲突如果系统中存在多个Node.js版本如通过apt和nvm同时安装可能导致不可预知的问题。建议使用nvm统一管理所有版本完全卸载其他安装方式的Node.js6.4 安装卡顿或失败特别是在安装依赖较多的项目时可能会遇到网络问题导致包下载失败系统工具链不完整如缺少Python、gcc等解决方案配置国内镜像源确保安装构建工具Windows: 安装Python和Visual Studio Build ToolsmacOS: 安装Xcode命令行工具Linux: 安装build-essential等基础开发包7. 进阶配置与优化7.1 使用npx替代全局安装npx是npm 5.2自带的一个工具可以临时下载并运行包避免全局安装npx create-react-app my-app7.2 缓存清理npm会缓存下载的包定期清理可以释放空间npm cache clean --force7.3 版本锁定在项目中使用package-lock.json或yarn.lock锁定依赖版本确保一致性npm install --package-lock-only7.4 安全审计定期检查项目依赖的安全性npm audit npm audit fix8. 多版本管理实践对于需要同时维护多个项目的开发者不同项目可能需要不同版本的Node.js。以下是推荐的工作流为每个项目创建.nvmrc文件指定Node.js版本进入项目目录时自动切换版本在shell配置中添加autoload -U add-zsh-hook load-nvmrc() { if [[ -f .nvmrc -r .nvmrc ]]; then nvm use fi } add-zsh-hook chpwd load-nvmrc使用npm的engines字段声明项目所需的Node.js版本范围在package.json中engines: { node: 14 17 }9. 卸载Node.js9.1 Windows系统卸载通过控制面板的程序和功能卸载Node.js手动删除剩余文件C:\Program Files\nodejsC:\Users\YourUser\AppData\Roaming\npm9.2 macOS/Linux卸载使用安装时的逆操作如果是通过包管理器安装使用相应命令卸载如果是通过nvm安装直接删除对应版本nvm uninstall 14.17.09.3 完全清理卸载后还需要清理以下目录~/.npm~/.node-gyp/usr/local/lib/node_modules/usr/local/include/node10. 安装验证与第一个程序完成安装后让我们创建一个简单的Node.js程序验证安装创建hello.js文件console.log(Node.js安装成功); console.log(当前Node版本${process.version}); console.log(当前系统平台${process.platform});运行程序node hello.js如果看到输出信息说明安装成功。对于更复杂的项目可以初始化一个新的npm项目mkdir my-project cd my-project npm init -y npm install express这将创建一个包含基本package.json的新项目并安装Express框架。
