作者Alun

前端开发技术分享:现代Web开发实践

从基础到进阶的前端技术栈

前端开发JavaScriptWeb技术
前端开发技术分享:现代Web开发实践
题图

前言

一个页面从“能显示”到“能交给别人用”,中间还有不少事情:按钮点击以后状态怎样变化,请求失败时显示什么,刷新深层地址还能不能打开,构建产物又是怎样送到服务器上的。单看框架名字,很难理解这些环节为什么需要放在一起。

这篇文章把常见前端代码放回这条工作流程里看。React 和 Vue 用来说明状态与渲染,构建配置负责把源码变成浏览器能加载的产物,请求、路由和部署则决定页面离开开发服务器以后能否正常工作。读的时候可以先选一套框架,不必把所有例子都装进同一个项目。

从浏览器交互到请求、状态更新与渲染的闭环

现代前端技术栈

下文是独立片段,分别面向 React、Vue 或静态站点,不能把它们当作一个项目直接拼接。配置必须匹配项目依赖版本,先明确运行环境与入口文件。

1. 核心技术

// 现代前端三件套
const coreTechnologies = {
    markup: 'HTML',
    language: 'JavaScript (ES6+)',
    styling: 'CSS3 + 预处理器',
    responsive: '移动端优先设计'
};

2. 框架选择

目前主流的前端框架有:

React

// React 函数组件示例
import React, { useState } from 'react';

function Counter() {
    const [count, setCount] = useState(0);
    
    return (
        <div>
            <p>Count: {count}</p>
            <button onClick={() => setCount(value => value + 1)}>
                Increment
            </button>
        </div>
    );
}

Vue.js

<!-- Vue 3 Composition API -->
<template>
    <div>
        <p>Count: {{ count }}</p>
        <button @click="increment">Increment</button>
    </div>
</template>

<script>
import { ref } from 'vue';

export default {
    setup() {
        const count = ref(0);
        
        const increment = () => {
            count.value++;
        };
        
        return {
            count,
            increment
        };
    }
};
</script>

3. 构建工具

Vite

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

export default defineConfig({
    plugins: [react()],
    server: {
        port: 3000,
        open: true
    }
});

Webpack

// webpack.config.cjs(CommonJS;ESM 项目也可使用此扩展名)
module.exports = {
    entry: './src/index.js',
    output: {
        filename: 'bundle.js',
        path: __dirname + '/dist'
    },
    module: {
        rules: [
            {
                test: /\.css$/,
                use: ['style-loader', 'css-loader']
            }
        ]
    }
};

开发服务器跑通以后,还要检查什么

开发时能打开页面,只说明开发服务器提供了需要的转换与资源。发布时浏览器加载的是构建目录里的文件,入口路径、资源前缀和宿主返回的内容都可能发生变化。因此每次调整构建配置后,应该实际生成一次产物,再用预览或静态服务器访问,而不是只看终端里有没有红字。

配置也不宜按“选项越多越专业”的思路叠加。先弄清入口在哪里、哪些文件需要转换、输出到哪里,再按需求加入插件。出了问题时,知道每条配置在解决什么,才能判断该改源码、构建还是托管设置。

CSS预处理器和框架

1. Sass/SCSS

@use "sass:color";

// variables.scss
$primary-color: #007bff;
$secondary-color: #6c757d;

// styles.scss
.button {
    background-color: $primary-color;
    border: none;
    border-radius: 4px;
    
    &:hover {
        background-color: color.adjust($primary-color, $lightness: -10%, $space: hsl);
    }
}

2. TailwindCSS

<!-- 使用 TailwindCSS -->
<button class="bg-blue-500 hover:bg-blue-700 text-white font-bold py-2 px-4 rounded">
    Click me
</button>

3. Bootstrap 5

<!-- Bootstrap 5 示例 -->
<div class="container">
    <div class="row">
        <div class="col-md-6">
            <h2>Responsive Design</h2>
            <p>Bootstrap makes responsive design easy!</p>
        </div>
    </div>
</div>

状态管理

1. React 状态管理

Redux Toolkit

新代码使用 Redux Toolkit;以下 store 仍需通过 React-Redux Provider 接入组件。

// store.js
import { configureStore, createSlice } from '@reduxjs/toolkit';

const counter = createSlice({
    name: 'counter',
    initialState: { count: 0 },
    reducers: {
        increment(state) { state.count += 1; }
    }
});
export const { increment } = counter.actions;
export const store = configureStore({ reducer: { counter: counter.reducer } });

Context API

// UserContext.js
import React, { createContext, useContext, useState } from 'react';

const UserContext = createContext();

export function useUser() {
    return useContext(UserContext);
}

export function UserProvider({ children }) {
    const [user, setUser] = useState(null);
    
    return (
        <UserContext.Provider value={{ user, setUser }}>
            {children}
        </UserContext.Provider>
    );
}

2. Vue 状态管理

Pinia (Vue 3)

// stores/user.js
import { defineStore } from 'pinia';

export const useUserStore = defineStore('user', {
    state: () => ({
        user: null,
        isLoggedIn: false
    }),
    actions: {
        setUser(userData) {
            this.user = userData;
            this.isLoggedIn = true;
        },
        logout() {
            this.user = null;
            this.isLoggedIn = false;
        }
    }
});

状态应该放在哪里

可以从一个表单出发判断。只有输入框自己用的临时内容,留在组件附近就足够;同一页面的兄弟组件都需要读写时,再把状态提升到共同的上层。登录用户、跨页面草稿这类长期共享的信息,才更值得讨论全局存储。

是否全局共享,与是否需要持久化又是两回事。放进 store 的数据,刷新页面后也可能消失;写进 localStorage 的数据,又需要考虑失效、版本变化和主动清除。把“谁需要用”和“需要保存多久”分开问,往往就能缩小工具选择范围。

上面的计数器适合演示更新机制,却不能代表真实业务的全部状态。一次请求还会经历等待、成功、失败等阶段;如果只有一个 data 字段而没有状态区分,空白界面既可能表示没数据,也可能表示请求还没完成,用户就不知道该等待还是重试。

路由管理

React Router

使用 history 路由的 SPA 需要宿主把未知应用路径回退到入口 HTML;纯静态托管没有这个能力时,可考虑 hash 路由。

// App.js
import { BrowserRouter, Routes, Route } from 'react-router-dom';
import Home from './pages/Home';
import About from './pages/About';

function App() {
    return (
        <BrowserRouter>
            <Routes>
                <Route path="/" element={<Home />} />
                <Route path="/about" element={<About />} />
            </Routes>
        </BrowserRouter>
    );
}

Vue Router

// router/index.js
import { createRouter, createWebHistory } from 'vue-router';
import Home from '../views/Home.vue';

const routes = [
    { path: '/', component: Home },
    { path: '/about', component: About }
];

export const router = createRouter({
    history: createWebHistory(),
    routes
});

API 交互

1. Fetch API

Fetch 遇到 HTTP 404/500 不会自动 reject;必须检查 response.ok。此例把错误继续抛给调用方,由界面呈现错误与重试状态。

// 使用 Fetch API
async function fetchData() {
    try {
        const response = await fetch('/api/data');
        if (!response.ok) throw new Error(`HTTP ${response.status}`);
        const data = await response.json();
        return data;
    } catch (error) {
        console.error('Error:', error);
        throw error;
    }
}

2. Axios

// 使用 Axios
import axios from 'axios';

const api = axios.create({
    baseURL: 'https://api.example.com',
    timeout: 10000
});

// 请求拦截器
api.interceptors.request.use(config => {
    // 添加认证 token
    const token = localStorage.getItem('token');
    if (token) {
        config.headers.Authorization = `Bearer ${token}`;
    }
    return config;
});

把错误交回到能处理它的地方

请求函数负责说明成功拿到了什么,或者为什么失败;界面负责把这个结果变成用户能理解的反馈。上面的 Fetch 示例在记录错误后继续抛出,就是为了让调用方有机会停止加载、保留旧数据、显示重试按钮。

还要考虑请求之间的关系。用户快速切换两次筛选条件,第一次请求可能比第二次更晚返回。如果不区分它们,界面就会被旧结果覆盖。可以在调用层跟踪当前请求,或使用取消机制;具体选择取决于业务,但“后来返回”不等于“用户最后想看的结果”。

性能优化

1. 代码分割

// React 代码分割
import { lazy, Suspense } from 'react';

const LazyComponent = lazy(() => import('./LazyComponent'));

function App() {
    return (
        <Suspense fallback={<div>Loading...</div>}>
            <LazyComponent />
        </Suspense>
    );
}

2. 图片优化

<!-- 响应式图片 -->
<img 
    src="image-small.jpg" 
    srcset="image-medium.jpg 1000w, image-large.jpg 2000w"
    sizes="(max-width: 600px) 100vw, 50vw"
    alt="Optimized image"
>

<!-- WebP 格式 -->
<picture>
    <source srcset="image.webp" type="image/webp">
    <img src="image.jpg" alt="Fallback image">
</picture>

3. 缓存策略

以下只演示安装期预缓存,尚未实现 fetch 读取缓存、旧缓存清理与更新策略,因此不能单凭此段声称离线可用。资源路径必须换成真实构建产物;带哈希的文件名不宜手写。

// Service Worker 缓存
const CACHE_NAME = 'my-app-cache-v1';
const urlsToCache = [
    '/',
    '/static/js/bundle.js',
    '/static/css/main.css'
];

self.addEventListener('install', event => {
    event.waitUntil(
        caches.open(CACHE_NAME)
            .then(cache => cache.addAll(urlsToCache))
    );
});

优化要对应用户能感受到的等待

代码分割主要推迟暂时用不到的代码;图片优化主要减少下载和解码成本;缓存则尝试复用已经拿到的资源。它们解决的不是同一个问题,不能把几项配置加上就认为性能已经完成。

例如首页图片很大,但点击详情后才用到的编辑器代码也进入了首页包,可以分别检查首屏图片尺寸和代码加载时机。反过来,如果卡顿发生在输入过程中,继续压缩图片未必有帮助,应该观察交互触发了哪些计算和渲染。先复现用户等待的那一步,再选择对应手段。

开发工具

1. 代码格式化

.prettierrc:

{
    "semi": true,
    "trailingComma": "es5",
    "singleQuote": true,
    "printWidth": 80,
    "tabWidth": 4
}

2. ESLint 配置

ESLint 使用匹配依赖版本的配置。下面为平面配置与 JavaScript 基础规则,React、TypeScript 与浏览器全局变量需按项目补充。

// eslint.config.js(ESM 项目)
import js from '@eslint/js';
export default [
    { ignores: ['dist/**', 'node_modules/**'] },
    js.configs.recommended,
    { rules: { 'no-console': 'warn' } }
];

3. 开发服务器配置

package.json 中的相关字段(依赖项需另行声明):

{
    "scripts": {
        "dev": "vite",
        "build": "vite build",
        "preview": "vite preview",
        "lint": "eslint ."
    }
}

部署策略

1. 静态网站托管

静态站点需要把构建产物交给部署任务,不能假设前一任务的工作目录自动共享。可使用本站的 部署工作流作为具体项目示例,或参考下一篇 开源项目实践中的完整 Pages 构建与部署配置。

项目的 Node.js 版本应与 engines 和锁文件匹配;不要复制已结束维护的 Node 16 环境。Actions 的触发分支也要与实际仓库一致,本站是 master。

2. Docker 部署

# 面向产出 dist/ 的纯静态前端,假设仓库已有 package-lock.json。
FROM node:24-alpine AS build
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

FROM nginx:stable-alpine
COPY --from=build /app/dist /usr/share/nginx/html
EXPOSE 80

构建上下文应通过 .dockerignore 排除 node_modules、dist、.git 与本地秘密文件。上述 Nginx 示例适用于静态文件,history 路由 SPA 需额外配置 fallback,SSR 服务需使用对应服务端产物。

结语

可以用一个小页面把本文串起来:加载一份数据,区分等待与错误,让用户切换内容,再构建并部署到实际托管环境。每一步都有可观察的结果,也能看出框架、状态、请求和部署各自负责什么。

等这条路径稳定以后,再加入代码分割、缓存或更复杂的状态管理。这样每项工具都有明确用途,遇到问题时也知道应该先检查哪一层。

如果你有其他前端开发的问题或经验分享,欢迎在评论区交流讨论!

相关链接

校订参考:MDN Fetch、Redux Toolkit 官方说明、Sass 颜色函数迁移。

评论