Vite 中文指南：从入门到性能优化，配置、插件与部署全解析

🇺🇸English

When to use this skill

Use this skill whenever the user wants to:

• Follow Vite Guide topics from getting started to performance
• Configure Vite using the official config reference
• Select or understand Vite plugins from the official plugins page
• Use Vite CLI, HMR API, or JavaScript API
• Handle SSR, backend integration, or deployment scenarios in Vite

How to use this skill

1. Identify the topic from the user request.
2. Open the matching guide example file in examples/guide/.
3. If configuration is needed , open the matching file in examples/config/.
4. If plugin selection is needed , open examples/plugins.md.
5. Follow official docs verbatim and keep output consistent with the referenced page.
6. Validate : Run npm run build to verify config changes compile; npm run preview to test production output.

Guide mapping (one-to-one with https://cn.vitejs.dev/guide/)

Introduction

• examples/guide/getting-started.md → https://cn.vitejs.dev/guide/
• examples/guide/philosophy.md → https://cn.vitejs.dev/guide/philosophy.html
• examples/guide/why-vite.md → https://cn.vitejs.dev/guide/why.html

Guide

• examples/guide/features.md → https://cn.vitejs.dev/guide/features.html
• examples/guide/cli.md → https://cn.vitejs.dev/guide/cli.html
• examples/guide/using-plugins.md → https://cn.vitejs.dev/guide/using-plugins.html
• examples/guide/dep-pre-bundling.md → https://cn.vitejs.dev/guide/dep-pre-bundling.html
• examples/guide/assets.md → https://cn.vitejs.dev/guide/assets.html
• examples/guide/build.md → https://cn.vitejs.dev/guide/build.html

APIs

• examples/guide/api-plugin.md → https://cn.vitejs.dev/guide/api-plugin.html
• examples/guide/api-hmr.md → https://cn.vitejs.dev/guide/api-hmr.html
• examples/guide/api-javascript.md → https://cn.vitejs.dev/guide/api-javascript.html

Environment API

• examples/guide/api-environment.md → https://cn.vitejs.dev/guide/api-environment.html
• examples/guide/api-environment-instances.md → https://cn.vitejs.dev/guide/api-environment-instances.html
• examples/guide/api-environment-plugins.md → https://cn.vitejs.dev/guide/api-environment-plugins.html
• examples/guide/api-environment-frameworks.md → https://cn.vitejs.dev/guide/api-environment-frameworks.html
• examples/guide/api-environment-runtimes.md → https://cn.vitejs.dev/guide/api-environment-runtimes.html

Config mapping (one-to-one with https://cn.vitejs.dev/config/)

• examples/config/configuring-vite.md → https://cn.vitejs.dev/config/
• examples/config/shared-options.md → https://cn.vitejs.dev/config/shared-options.html
• examples/config/server-options.md → https://cn.vitejs.dev/config/server-options.html
• examples/config/build-options.md → https://cn.vitejs.dev/config/build-options.html
• examples/config/preview-options.md → https://cn.vitejs.dev/config/preview-options.html
• examples/config/dep-optimization-options.md → https://cn.vitejs.dev/config/dep-optimization-options.html

Plugins mapping (one-to-one with https://cn.vitejs.dev/plugins/)

• examples/plugins.md → https://cn.vitejs.dev/plugins/

Inline Quick Start

# Create a new Vite project
npm create vite@latest my-app -- --template react-ts

# Install and run
cd my-app && npm install
npm run dev      # Dev server with HMR
npm run build    # Production build
npm run preview  # Preview production build



// vite.config.ts
import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';

export default defineConfig({
  plugins: [react()],
  server: {
    port: 3000,
    proxy: {
      '/api': 'http://localhost:8080',
    },
  },
  build: {
    sourcemap: true,
    rollupOptions: {
      output: {
        manualChunks: { vendor: ['react', 'react-dom'] },
      },
    },
  },
});

Best Practices

• Use defineConfig for TypeScript type hints and autocomplete
• Configure proxy in server.proxy for API calls during development
• Use build.rollupOptions.output.manualChunks for vendor splitting
• Enable source maps in development; disable in production for smaller builds
• Use import.meta.env for environment variables (prefix with VITE_)

Resources

• Guide: https://cn.vitejs.dev/guide/
• Config: https://cn.vitejs.dev/config/
• Plugins: https://cn.vitejs.dev/plugins/

Keywords

Vite, build tool, dev server, HMR, config, plugins, SSR, CLI, dependency pre-bundling, assets

Weekly Installs

55

Repository

teachingai/full…k-skills

GitHub Stars

220

First Seen

Jan 24, 2026

Security Audits

Gen Agent Trust HubPassSocketPassSnykPass

Installed on

opencode47

gemini-cli45

codex45

github-copilot42

claude-code38

cursor38