环境配置

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

安装 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

3. 验证安装：

   node -v
   npm -v

安装 pnpm

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

npm install -g pnpm

验证安装：

pnpm -v

安装 Puppeteer 浏览器

Puppeteer 需要下载 Chromium 浏览器：

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

验证环境

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

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

常见问题

1. Node.js 版本过低

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

2. Puppeteer 下载失败

如果 Chromium 下载速度慢，可以设置代理：

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

或者使用国内镜像：

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

3. pnpm 安装失败

如果全局安装 pnpm 失败，可以尝试：

# 使用 corepack（Node.js 内置）
corepack enable
corepack prepare pnpm@latest --activate

下一步

环境配置完成后，我们就可以开始创建项目了。