Empaquetado y despliegue — Despliegue en Vercel

En este capítulo aprenderás a empaquetar el proyecto de blog desarrollado localmente y a desplegarlo gratuitamente en Internet, obteniendo un enlace de acceso público.


Construir el paquete de producción

Al ejecutar en desarrollonpm run dev, Vite inicia un servidor de desarrollo local, con soporte de actualización en caliente.

Lo que se necesita para el despliegue esel paquete de producción optimizado y comprimido.。

$ npm run build

Después de ejecutarlo, se genera en la raíz del proyectodist/la carpeta:

dist/
├── index.html                # 入口 HTML
├── assets/
│   ├── index-Df3aBc9x.js    # 打包压缩后的 JS
│   ├── index-Gh7jKl2m.css   # 提取并压缩后的 CSS
│   └── ...
├── posts.json                # public 目录文件原样复制
└── favicon.svg               # 静态资源

Cambios clave:

  • El nombre del archivo incluye un hash (si el contenido cambia, el hash cambia; se usa para el control de caché del navegador)
  • El código está comprimido y se ha aplicado Tree-shaking (eliminación de código no utilizado)
  • El contenido del directorio public/ se copia tal cual a la raíz

Para previsualizar el resultado de la compilación, ejecutanpx vite preview, iniciando el servicio en modo producción localmente para simular el entorno en línea.


Subir el proyecto a GitHub

Primer paso: crear un repositorio en GitHub

En GitHub, haz clic en + → New repository y completa:

  • Repository name:react-blog-app
  • Establécelo como Public (despliegue gratuito)
  • No marques "Initialize with README"

Segundo paso: inicializar Git y subir

$ cd blog-app
$ git init
$ git add .
$ git commit -m "初始化 React 博客项目"
$ git branch -M main
$ git remote add origin https://github.com/你的用户名/react-blog-app.git
$ git push -u origin main

Antes de hacer push, asegúrate de que.gitignoreincluyenode_modulesydist. node_modules no debe subirse (se puede restaurar con npm install), dist lo genera automáticamente la plataforma de compilación.


Despliegue en Vercel

Verceles la plataforma de despliegue frontend más popular actualmente, con soporte de configuración cero para proyectos React/Vite.

Pasos de despliegue

  1. Visitavercel.com, inicia sesión con tu cuenta de GitHub
  2. Haz clic en "New Project" → Import Git Repository → selecciona react-blog-app
  3. Vercel detecta automáticamente Vite + React, y la configuración se rellena automáticamente
  4. Haz clic en "Deploy" y espera unas decenas de segundos
  5. Después de un despliegue exitoso, obtendrás un enlace como:https://react-blog-app.vercel.app
Opción de configuraciónValorDescripción
Framework PresetViteDetección automática
Build Commandnpm run buildDetección automática
Output DirectorydistDetección automática

Despliegue automático

A partir de entonces, cada vez quegit push, Vercel automáticamente: descarga el código → npm install → npm run build → despliega en línea.

Todo el proceso es completamente automático, con hacer push se publica.


Dominio personalizado (opcional)

  1. Panel del proyecto en Vercel → Settings → Domains
  2. Introduce tu dominio (por ejemplo, blog.Python.com)
  3. Añade un registro CNAME en tu proveedor de DNS que apunte acname.vercel-dns.com
  4. Espera a que el DNS tenga efecto; Vercel solicita automáticamente el certificado SSL

Próximos pasos de aprendizaje

Dirección de aprendizajePara quién es adecuadoPunto de partida recomendado
TypeScript + ReactQuieres escribir proyectos grandes más rigurososAñade TypeScript al proyecto, empezando por los tipos de Props y Hooks
Next.jsNecesitas capacidades de SEO, SSR y full-stackFramework full-stack basado en React, los archivos son las rutas
React Query (TanStack Query)Necesitas una gestión de solicitudes de datos más potenteCaché, reobtención automática, actualizaciones optimistas
Librería de gestión de estadoLa lógica de estado de la aplicación es muy complejaZustand (ligero), Redux Toolkit (pesado)
Librería de componentesPara construir rápidamente un panel de administraciónAnt Design、MUI、shadcn/ui

Comparación de rutas full-stack: React vs Vue3

DirecciónEcosistema ReactEcosistema Vue3
Framework full-stackNext.jsNuxt.js
Sistema de tiposTypeScript (mejor soporte nativo)TypeScript
Gestión de estado (ligero)ZustandPinia
Solicitudes de datosReact QueryVueUse / TanStack Query
MóvilReact Native— (Weex ya no recibe actualizaciones)

El paso más importante ya lo has completado: crear un proyecto real completo con React. Ya sea TypeScript o Next.js en el futuro, todo consiste en añadir dimensiones sobre lo que ya tienes. La forma de pensar de React (vistas impulsadas por estado, componentes, flujo de datos unidireccional) será útil en cada uno de tus proyectos posteriores.

Otras extensiones