# {frontmatter.title}

在开始开发简历生成工具之前,需要先配置好开发环境。本章将指导你完成所有必要的环境配置。

安装 Node.js

  1. 访问 Node.js 官方网站下载最新的 LTS 版本: https://nodejs.org/

  2. 或者使用 nvm 安装(推荐):

   # 安装 nvm
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

   # 安装 Node.js
   nvm install --lts
   nvm use --lts
  1. 验证安装:
   node -v
   npm -v

安装 pnpm

pnpm 是一个快速、节省磁盘空间的包管理器:

npm install -g pnpm

验证安装:
```bash
pnpm -v

## 安装 Puppeteer 浏览器

Puppeteer 需要下载 Chromium 浏览器:

```bash
npx puppeteer browsers install chrome

::: tip
这个命令只需要在每个电脑上执行一次。它会下载一个独立的 Chromium 浏览器,不会影响系统已安装的浏览器。
:::

## 配置 VS Code

1. 安装 VS Code:
   https://code.visualstudio.com/

2. 安装必要的扩展:
   - Vue - Official (Vue Language Features)
   - TypeScript Vue Plugin (Volar)
   - ESLint

## 验证环境

确保以下命令都能正常运行:

```bash
node -v      # 应显示 v18.x.x 或更高版本
pnpm -v      # 应显示 pnpm 版本号

## 常见问题

### 1. Node.js 版本过低

确保 Node.js 版本 >= 18,Vite 5 和 Vue 3.4 需要较新的 Node.js 版本。

### 2. Puppeteer 下载失败

如果 Chromium 下载速度慢,可以设置代理:

```bash
HTTP_PROXY=http://proxy.example.com:8080 npx puppeteer browsers install chrome

或者使用国内镜像:

```bash
PUPPETEER_DOWNLOAD_HOST=https://registry.npmmirror.com/mirrors npx puppeteer browsers install chrome

### 3. pnpm 安装失败

如果全局安装 pnpm 失败,可以尝试:

```bash
# 使用 corepack(Node.js 内置)
corepack enable
corepack prepare pnpm@latest --activate

## 下一步

环境配置完成后,我们就可以开始[创建项目](./01-Create_Project.mdx)了。