Files
test-repo/docs/.vitepress/theme/components/appendix/ports-localhost/DevServerFlowDemo.vue
T
2026-02-24 00:18:09 +08:00

472 lines
11 KiB
Vue
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<script setup>
import { ref } from 'vue'
const currentStep = ref(0)
const isPlaying = ref(false)
const steps = [
{
title: '1. 你执行 npm run dev',
terminal: '$ npm run dev\n\n> vite\n\n 准备就绪...',
desc: '你在终端里敲下启动命令',
highlight: 'terminal'
},
{
title: '2. Vite 启动 HTTP 服务器',
terminal: '$ npm run dev\n\n> vite\n\n VITE v5.4.0 ready in 200 ms\n\n ➜ Local: http://localhost:5173/\n ➜ Network: http://192.168.1.10:5173/',
desc: 'Vite 在本机的 5173 端口启动了一个 HTTP 服务器,等待连接',
highlight: 'server'
},
{
title: '3. 你打开浏览器访问',
terminal: '$ npm run dev\n\n> vite\n\n VITE v5.4.0 ready in 200 ms\n\n ➜ Local: http://localhost:5173/\n ➜ Network: http://192.168.1.10:5173/',
browser: 'http://localhost:5173',
desc: '浏览器向 localhost:5173 发起 HTTP 请求',
highlight: 'browser'
},
{
title: '4. 服务器返回页面',
terminal: '$ npm run dev\n\n> vite\n\n VITE v5.4.0 ready in 200 ms\n\n ➜ Local: http://localhost:5173/\n ➜ Network: http://192.168.1.10:5173/\n\n 10:30:01 [200] /\n 10:30:01 [200] /src/main.js\n 10:30:01 [200] /src/App.vue',
browser: 'http://localhost:5173',
page: '🎉 你的页面出现了!',
desc: 'Vite 处理请求,返回 HTML/JS/CSS,浏览器渲染页面',
highlight: 'page'
},
{
title: '5. 热更新(HMR',
terminal: '$ npm run dev\n\n VITE v5.4.0 ready in 200 ms\n\n ➜ Local: http://localhost:5173/\n\n 10:30:01 [200] /\n 10:35:22 [vite] hmr update /src/App.vue',
browser: 'http://localhost:5173',
page: '🔄 页面自动刷新了!',
desc: '你修改代码后,Vite 通过 WebSocket 通知浏览器,页面自动更新',
highlight: 'hmr'
}
]
async function playAll() {
if (isPlaying.value) return
isPlaying.value = true
currentStep.value = 0
for (let i = 0; i < steps.length; i++) {
currentStep.value = i
await new Promise(r => setTimeout(r, 1800))
}
isPlaying.value = false
}
function goStep(i) {
currentStep.value = i
}
function reset() {
currentStep.value = 0
isPlaying.value = false
}
</script>
<template>
<div class="devserver-flow-demo">
<div class="control-panel">
<div class="step-indicators">
<div
v-for="(s, i) in steps"
:key="i"
:class="['step-dot', { active: currentStep >= i, current: currentStep === i }]"
@click="goStep(i)"
>
{{ i + 1 }}
</div>
</div>
<div class="control-btns">
<button class="action-btn" :disabled="isPlaying" @click="playAll">
{{ isPlaying ? '播放中...' : ' 自动演示' }}
</button>
<button class="action-btn ghost" @click="reset">重置</button>
</div>
</div>
<div class="visualization-area">
<div class="step-title">{{ steps[currentStep].title }}</div>
<div class="flow-layout">
<div :class="['panel terminal-panel', { highlight: steps[currentStep].highlight === 'terminal' }]">
<div class="panel-header">
<span class="dot red" /><span class="dot yellow" /><span class="dot green" />
<span class="panel-title">终端</span>
</div>
<pre class="terminal-content">{{ steps[currentStep].terminal }}</pre>
</div>
<div class="arrow-col">
<div :class="['flow-arrow', { active: currentStep >= 1 }]">
<span class="arrow-label">监听</span>
<span class="arrow-char"></span>
</div>
</div>
<div :class="['panel browser-panel', {
highlight: steps[currentStep].highlight === 'browser' || steps[currentStep].highlight === 'page' || steps[currentStep].highlight === 'hmr'
}]"
>
<div class="panel-header">
<span class="dot red" /><span class="dot yellow" /><span class="dot green" />
<span class="panel-title">浏览器</span>
</div>
<div class="browser-content">
<div v-if="steps[currentStep].browser" class="browser-url-bar">
{{ steps[currentStep].browser }}
</div>
<div v-else class="browser-empty">等待你打开浏览器...</div>
<div v-if="steps[currentStep].page" class="browser-page">
{{ steps[currentStep].page }}
</div>
</div>
</div>
</div>
<div class="step-desc">
💡 {{ steps[currentStep].desc }}
</div>
</div>
<div class="http-explain">
<div class="http-title">什么是 HTTP 服务器</div>
<div class="http-analogy">
<div class="analogy-item">
<span class="analogy-icon">🏪</span>
<div class="analogy-text">
<strong>想象一个前台窗口</strong>
<span>HTTP 服务器就像一个"永远开着的服务窗口"它一直等在那里有人来问就回答没人来就静静等着</span>
</div>
</div>
<div class="analogy-item">
<span class="analogy-icon">📋</span>
<div class="analogy-text">
<strong>只懂一种"暗号"</strong>
<span>这个窗口只听得懂 HTTP 协议的请求格式比如 <code>GET /index.html</code>然后把对应的文件内容返回给你</span>
</div>
</div>
<div class="analogy-item">
<span class="analogy-icon"></span>
<div class="analogy-text">
<strong>开发服务器 = 加强版窗口</strong>
<span>ViteWebpack 的开发服务器不只是"原样返回文件"它还会即时编译你的代码Vue JSTS JSSass CSS然后再返回给浏览器</span>
</div>
</div>
</div>
</div>
<div class="info-box">
<strong>一句话总结</strong>开发服务器 = 一个运行在 localhost 上的 HTTP 服务器 + 即时代码编译器它监听某个端口浏览器来请求它就把编译好的代码返回
</div>
</div>
</template>
<style scoped>
.devserver-flow-demo {
border: 1px solid var(--vp-c-divider);
border-radius: 6px;
background-color: var(--vp-c-bg-soft);
overflow: hidden;
margin: 0.5rem 0;
}
.control-panel {
padding: 1rem;
background: var(--vp-c-bg);
border-bottom: 1px solid var(--vp-c-divider);
display: flex;
justify-content: space-between;
align-items: center;
flex-wrap: wrap;
gap: 0.5rem;
}
.step-indicators {
display: flex;
gap: 0.4rem;
}
.step-dot {
width: 28px;
height: 28px;
border-radius: 50%;
display: flex;
align-items: center;
justify-content: center;
font-size: 0.75rem;
font-weight: 700;
cursor: pointer;
border: 2px solid var(--vp-c-divider);
color: var(--vp-c-text-3);
background: var(--vp-c-bg);
transition: all 0.2s;
}
.step-dot.active {
border-color: var(--vp-c-brand);
color: var(--vp-c-brand);
}
.step-dot.current {
background: var(--vp-c-brand);
color: white;
border-color: var(--vp-c-brand);
}
.control-btns {
display: flex;
gap: 0.4rem;
}
.action-btn {
padding: 0.35rem 0.7rem;
background: var(--vp-c-brand);
color: white;
border: none;
border-radius: 4px;
cursor: pointer;
font-size: 0.82rem;
font-weight: 600;
transition: opacity 0.2s;
}
.action-btn:disabled {
opacity: 0.6;
cursor: not-allowed;
}
.action-btn.ghost {
background: transparent;
color: var(--vp-c-text-2);
border: 1px solid var(--vp-c-divider);
}
.visualization-area {
padding: 1rem;
}
.step-title {
font-weight: 700;
font-size: 0.95rem;
margin-bottom: 0.75rem;
color: var(--vp-c-brand);
}
.flow-layout {
display: grid;
grid-template-columns: 1fr auto 1fr;
gap: 0.5rem;
align-items: stretch;
}
.panel {
border: 2px solid var(--vp-c-divider);
border-radius: 8px;
overflow: hidden;
background: var(--vp-c-bg);
transition: border-color 0.3s, box-shadow 0.3s;
}
.panel.highlight {
border-color: var(--vp-c-brand);
box-shadow: 0 0 12px rgba(100, 108, 255, 0.2);
}
.panel-header {
display: flex;
align-items: center;
gap: 0.3rem;
padding: 0.4rem 0.6rem;
background: var(--vp-c-bg-alt);
border-bottom: 1px solid var(--vp-c-divider);
}
.dot {
width: 8px;
height: 8px;
border-radius: 50%;
}
.dot.red { background: #ef4444; }
.dot.yellow { background: #f59e0b; }
.dot.green { background: #10b981; }
.panel-title {
font-size: 0.78rem;
font-weight: 600;
margin-left: 0.3rem;
color: var(--vp-c-text-2);
}
.terminal-content {
padding: 0.75rem;
font-family: var(--vp-font-family-mono);
font-size: 0.75rem;
line-height: 1.5;
color: var(--vp-c-text-1);
margin: 0;
min-height: 140px;
white-space: pre-wrap;
word-break: break-all;
}
.browser-content {
padding: 0.75rem;
min-height: 140px;
display: flex;
flex-direction: column;
gap: 0.5rem;
}
.browser-url-bar {
background: var(--vp-c-bg-alt);
padding: 0.35rem 0.6rem;
border-radius: 4px;
font-family: var(--vp-font-family-mono);
font-size: 0.78rem;
color: var(--vp-c-text-2);
border: 1px solid var(--vp-c-divider);
}
.browser-empty {
color: var(--vp-c-text-3);
font-size: 0.85rem;
text-align: center;
padding: 2rem 0;
}
.browser-page {
flex: 1;
display: flex;
align-items: center;
justify-content: center;
font-size: 1.1rem;
font-weight: 700;
color: var(--vp-c-brand);
}
.arrow-col {
display: flex;
align-items: center;
justify-content: center;
}
.flow-arrow {
display: flex;
flex-direction: column;
align-items: center;
gap: 0.2rem;
opacity: 0.3;
transition: opacity 0.3s;
}
.flow-arrow.active {
opacity: 1;
}
.arrow-label {
font-size: 0.68rem;
color: var(--vp-c-text-3);
writing-mode: vertical-rl;
}
.arrow-char {
font-size: 1.2rem;
color: var(--vp-c-brand);
}
.step-desc {
margin-top: 0.75rem;
padding: 0.6rem 0.75rem;
background: var(--vp-c-bg);
border-radius: 6px;
border: 1px solid var(--vp-c-divider);
font-size: 0.88rem;
color: var(--vp-c-text-2);
}
.http-explain {
padding: 1rem;
border-top: 1px solid var(--vp-c-divider);
}
.http-title {
font-weight: 700;
font-size: 0.92rem;
margin-bottom: 0.6rem;
color: var(--vp-c-text-1);
}
.http-analogy {
display: flex;
flex-direction: column;
gap: 0.5rem;
}
.analogy-item {
display: flex;
align-items: flex-start;
gap: 0.6rem;
padding: 0.6rem 0.75rem;
background: var(--vp-c-bg);
border: 1px solid var(--vp-c-divider);
border-radius: 6px;
}
.analogy-icon {
font-size: 1.2rem;
flex-shrink: 0;
margin-top: 0.1rem;
}
.analogy-text {
display: flex;
flex-direction: column;
gap: 0.15rem;
}
.analogy-text strong {
font-size: 0.85rem;
}
.analogy-text span {
font-size: 0.82rem;
color: var(--vp-c-text-2);
line-height: 1.5;
}
.analogy-text code {
font-size: 0.78rem;
background: var(--vp-c-bg-alt);
padding: 0.1rem 0.3rem;
border-radius: 3px;
}
.info-box {
padding: 0.75rem 1rem;
background: var(--vp-c-bg);
border-top: 1px solid var(--vp-c-divider);
font-size: 0.88rem;
color: var(--vp-c-text-2);
display: flex;
gap: 0.25rem;
}
.info-box strong {
white-space: nowrap;
flex-shrink: 0;
}
@media (max-width: 640px) {
.flow-layout {
grid-template-columns: 1fr;
}
.arrow-col {
transform: rotate(90deg);
padding: 0.3rem 0;
}
.arrow-label {
writing-mode: horizontal-tb;
}
}
</style>