ViteKit CLI安装
本页面详细介绍了 ViteKit CLI 的各种安装方式和系统要求。
系统要求
- Node.js: 版本 16.0 或更高
- npm: 版本 7.0 或更高（或 yarn 1.22+）
- 操作系统: Windows 10+, macOS 10.15+, 或 Linux
安装方式
全局安装（推荐）
全局安装 ViteKit CLI，这样您可以在任何地方使用 vitekit 命令：
bash
npm install -g vitekit-cli
安装完成后，验证安装：
bash
vitekit --version
使用 Yarn
如果您使用 Yarn 作为包管理器：
bash
yarn global add vitekit-cli
使用 pnpm
如果您使用 pnpm：
bash
pnpm add -g vitekit-cli
使用 npx（无需安装）
如果您不想全局安装，可以使用 npx 直接运行：
bash
npx vitekit-cli my-project
这种方式会自动下载最新版本的 ViteKit CLI 并运行。
验证安装
安装完成后，运行以下命令验证安装是否成功：
bash
vitekit --help
您应该看到类似以下的输出：
Usage: vitekit [options] [project-name]
Options:
-V, --version output the version number
-t, --template <name> specify template name
-h, --help display help for command
更新
更新到最新版本
bash
npm update -g vitekit-cli
检查当前版本
bash
vitekit --version
查看可用版本
bash
npm view vitekit-cli versions --json
卸载
如果需要卸载 ViteKit CLI：
bash
npm uninstall -g vitekit-cli
故障排除
权限问题
如果在 macOS 或 Linux 上遇到权限问题，可以使用以下方法之一：
方法 1: 使用 sudo（不推荐）
bash
sudo npm install -g vitekit-cli
方法 2: 配置 npm 全局目录（推荐）
bash
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.profile
source ~/.profile
然后重新安装：
bash
npm install -g vitekit-cli
网络问题
如果遇到网络问题，可以尝试使用国内镜像：
bash
npm install -g vitekit-cli --registry=https://registry.npmmirror.com
Node.js 版本问题
如果您的 Node.js 版本过低，请升级到 16.0 或更高版本：
bash
# 使用 nvm 升级 Node.js
nvm install node
nvm use node
开发版本
如果您想使用最新的开发版本（可能不稳定）：
bash
npm install -g vitekit-cli@beta
下一步
安装完成后，您可以：