第二章：环境搭建与安装

2.1 安装Node.js和npm

为什么需要Node.js和npm？

在开始使用Shadcn之前，我们需要确保开发环境中已安装Node.js和npm（Node Package Manager）。它们是现代前端开发的基石：

• Node.js：提供JavaScript运行时环境，使JavaScript能够脱离浏览器运行
• npm：Node.js的默认包管理器，用于安装和管理项目依赖

安装步骤

Windows/macOS用户

1. 访问Node.js官网
2. 下载LTS版本（长期支持版，推荐大多数用户）
3. 运行安装程序，保持默认配置
4. 安装完成后验证：

   node -v
   npm -v
   

Linux用户（以Ubuntu为例）

# 使用NodeSource安装
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证安装
node -v
npm -v

常见问题解决

1. 权限问题：

   • 避免使用sudo安装全局包
   • 推荐配置npm全局安装目录：

     mkdir ~/.npm-global
     npm config set prefix '~/.npm-global'
     

2. 版本过旧：

   • 使用nvm（Node Version Manager）管理多版本：

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

配置npm（可选但推荐）

# 设置淘宝镜像（中国大陆用户）
npm config set registry https://registry.npmmirror.com

# 提高安装速度
npm config set fetch-retries 3
npm config set fetch-retry-mintimeout 10000

注意：完成安装后，建议重启终端使配置生效。下一节我们将使用这些工具创建React项目。