普通视图

发现新文章,点击刷新页面。
今天 — 2025年11月12日首页
昨天 — 2025年11月11日首页

Vue 项目上线前必查!8 个易忽略知识点,90% 开发者都踩过坑

作者 zzpper
2025年11月10日 23:42

Vue 项目上线前必查!8 个易忽略知识点,90% 开发者都踩过坑

最近最近接手了一个朋友的 Vue3 项目,改 bug 改到怀疑人生 —— 明明语法看着没毛病,页面就是不更新;父子组件传值偶尔失效;打包后样式突然错乱… 排查后发现全是些 “不起眼” 的知识点在作祟。

这些知识点不像响应式、生命周期那样被反复强调,却偏偏是面试高频考点和项目线上问题的重灾区。今天就带大家逐个拆解,每个都附代码示例和避坑方案,新手能避坑,老手能查漏,建议收藏备用!🚀

1. Scoped 样式的 “隐形泄露”,父子组件样式串味了

写组件时大家都习惯加scoped让样式局部化,但你可能遇到过:父组件的样式莫名其妙影响了子组件?这可不是 Vue 的 bug。

隐藏陷阱

Vue 为scoped样式的元素添加独特属性(如data-v-xxx)来隔离样式,但子组件的根节点会同时继承父组件和自身的 scoped 样式。比如这样的代码:

vue

<!-- 父组件 App.vue -->
<template>
  <h4>父组件标题</h4>
  <HelloWorld />
</template>
<style scoped>
h4 { color: red; }
</style>

<!-- 子组件 HelloWorld.vue -->
<template>
  <h4>子组件标题</h4> <!-- 会被父组件的red样式影响 -->
</template>
<style scoped></style>

最终子组件的 h4 也会变成红色,很多人第一次遇到都会懵圈。

避坑方案

  1. 给子组件根元素加唯一 class,避免标签选择器冲突

    vue

    <!-- 优化后 HelloWorld.vue -->
    <template>
      <div class="hello-world">
        <h4>子组件标题</h4>
      </div>
    </template>
    
  2. Vue3 支持多根节点,直接用多个根元素打破继承链

  3. 尽量用 class 选择器替代标签选择器,减少冲突概率

2. 数组 / 对象响应式失效?别再直接改索引了

这是 Vue 响应式系统的经典 “坑”,Vue3 用 Proxy 优化了不少,但某些场景依然会踩雷。

隐藏陷阱

Vue 的响应式依赖数据劫持实现,但以下两种操作无法被监听:

  1. 给对象新增未声明的属性
  2. 直接修改数组索引或长度

vue

<template>
  <div>{{ user.age }}</div>
  <div>{{ list[0] }}</div>
  <button @click="modifyData">修改数据</button>
</template>
<script setup>
import { reactive } from 'vue'
const user = reactive({ name: '张三' })
const list = reactive(['苹果'])

const modifyData = () => {
  user.age = 25 // 新增属性,页面不更新
  list[0] = '香蕉' // 直接改索引,页面不更新
}
</script>

点击按钮后,数据确实变了,但页面纹丝不动。

避坑方案

针对不同数据类型用正确姿势修改:

vue

<script setup>
import { reactive } from 'vue'
const user = reactive({ name: '张三' })
const list = reactive(['苹果'])

const modifyData = () => {
  // 对象新增属性:直接赋值即可(Vue3 Proxy支持)
  user.age = 25 
  // 数组修改:用splice或替换数组
  list.splice(0, 1, '香蕉') 
  // 也可直接替换整个数组
  // list = ['香蕉', '橙子']
}
</script>

小贴士:Vue2 中需用this.$set(user, 'age', 25),Vue3 的 Proxy 无需额外 API,但修改数组索引仍需用数组方法。

3. setup 里的异步请求,别漏了 Suspense 配合

Vue3 的 Composition API 是趋势,但很多人在 setup 里写异步请求时,遇到过数据渲染延迟或报错的问题。

隐藏陷阱

setup 函数执行时组件还未挂载,若直接在 setup 中写 async/await,返回的 Promise 会导致组件渲染异常,因为 setup 本身不支持直接返回 Promise。

vue

<!-- 错误示例 -->
<script setup>
import axios from 'axios'
const data = ref(null)

// 直接用await会导致组件初始化异常
const res = await axios.get('/api/list') 
data.value = res.data
</script>

避坑方案

用 Vue3 内置的<Suspense>组件包裹异步组件,搭配异步 setup 使用:

vue

<!-- 父组件 -->
<template>
  <Suspense>
    <template #default>
      <DataList />
    </template>
    <template #fallback>
      <div>加载中...</div> <!-- 加载占位 -->
    </template>
  </Suspense>
</template>

<!-- DataList.vue 异步组件 -->
<script setup>
import { ref } from 'vue'
import axios from 'axios'
const data = ref(null)

// setup可以写成async函数
const fetchData = async () => {
  const res = await axios.get('/api/list')
  data.value = res.data
}
fetchData()
</script>

这样既能正常发起异步请求,又能优雅处理加载状态,提升用户体验。

4. 非 props 属性 “悄悄继承”,DOM 多了莫名属性

给组件传了没在 props 中声明的属性(如 id、class),结果发现子组件根元素自动多了这些属性,有时会导致样式或功能冲突。

隐藏陷阱

这是 Vue 的非 props 属性继承特性,像 id、class、name 这类未被 props 接收的属性,会默认挂载到子组件的根元素上。比如:

vue

<!-- 父组件 -->
<template>
  <UserCard id="user-card" class="card-style" />
</template>

<!-- 子组件 UserCard.vue 未声明对应props -->
<template>
  <div>用户信息卡片</div> <!-- 最终会被渲染为<div id="user-card" class="card-style"> -->
</template>

若子组件根元素已有 class,会和继承的 class 合并,有时会覆盖预期样式。

避坑方案

  1. 禁止继承:用inheritAttrs: false关闭自动继承

    vue

    <script setup>
    // 关闭非props属性继承
    defineOptions({ inheritAttrs: false }) 
    </script>
    
  2. 手动控制属性位置:用$attrs将属性挂载到指定元素

    vue

    <template>
      <div>
        <div v-bind="$attrs">只给这个元素加继承属性</div>
      </div>
    </template>
    

5. 生命周期的 “顺序陷阱”,父子组件执行顺序搞反了

Vue2 升级 Vue3 后,生命周期不仅改了命名,父子组件的执行顺序也有差异,这是面试高频题,也是项目中异步逻辑出错的常见原因。

隐藏陷阱

很多人仍沿用 Vue2 的思维写 Vue3 代码,比如认为父组件的onMounted会比子组件先执行,结果 DOM 操作时报错。

阶段 Vue2 执行顺序 Vue3 执行顺序
初始化 父 beforeCreate→父 created→父 beforeMount→子 beforeCreate→子 created→子 beforeMount→子 mounted→父 mounted 父 setup→父 onBeforeMount→子 setup→子 onBeforeMount→子 onMounted→父 onMounted

避坑方案

  1. 数据初始化:Vue3 可在 setup 中直接用 async/await 发起请求,配合 Suspense

  2. DOM 操作:务必在onMounted中执行,且要清楚子组件的 mounted 会比父组件先触发

  3. 清理工作:定时器、事件监听一定要在onBeforeUnmount中清除,避免内存泄漏

    vue

    <script setup>
    import { onMounted, onBeforeUnmount } from 'vue'
    let timer = null
    onMounted(() => {
      timer = setInterval(() => {
        console.log('定时器运行中')
      }, 1000)
    })
    // 组件卸载前清除定时器
    onBeforeUnmount(() => {
      clearInterval(timer)
    })
    </script>
    

6. CSS 中用 v-bind,动态样式的正确打开方式

Vue3.2 + 支持在 CSS 中直接用 v-bind 绑定数据,这个特性很实用,但很多人不知道它的底层逻辑和使用限制。

隐藏陷阱

直接在 CSS 中绑定计算属性时,误以为修改数据后样式不会实时更新,或者担心影响性能。

vue

<template>
  <div class="text">动态颜色文本</div>
  <button @click="changeColor">切换颜色</button>
</template>
<script setup>
import { ref, computed } from 'vue'
const primaryColor = ref('red')
const textColor = computed(() => primaryColor.value)
const changeColor = () => {
  primaryColor.value = primaryColor.value === 'red' ? 'blue' : 'red'
}
</script>
<style>
.text {
  color: v-bind(textColor);
}
</style>

避坑方案

  1. 无需担心性能:v-bind 会被编译成 CSS 自定义属性,通过内联样式应用到组件,数据变更时仅更新自定义属性
  2. 支持多种数据类型:可绑定 ref、reactive、computed,甚至是 props 传递的值
  3. 与 scoped 兼容:动态样式同样支持局部作用域,不会污染全局

7. ref 获取元素,别在 onMounted 前急着用

用 ref 获取 DOM 元素是基础操作,但新手常犯的错是在 DOM 未挂载完成时就调用元素方法。

隐藏陷阱

setuponBeforeMount中获取 ref,结果拿到undefined

vue

<template>
  <input ref="inputRef" type="text" />
</template>
<script setup>
import { ref, onBeforeMount } from 'vue'
const inputRef = ref(null)

onBeforeMount(() => {
  inputRef.value.focus() // 报错:Cannot read property 'focus' of null
})
</script>

避坑方案

  1. 基础用法:在onMounted中操作 ref 元素,此时 DOM 已完全挂载

    vue

    <script setup>
    import { ref, onMounted } from 'vue'
    const inputRef = ref(null)
    
    onMounted(() => {
      inputRef.value.focus() // 正常生效
    })
    </script>
    
  2. 动态元素:若 ref 绑定在 v-for 渲染的元素上,inputRef 会变成数组,需通过索引访问

  3. 组件 ref:获取子组件实例时,子组件需用defineExpose暴露属性和方法

8. watch 监听数组 / 对象,深度监听别写错了

watch 是 Vue 中处理响应式数据变化的核心 API,但监听复杂数据类型时,很容易出现 “监听不到变化” 的问题。

隐藏陷阱

直接监听数组或对象时,默认只监听引用变化,对内部属性的修改无法触发监听。

vue

<script setup>
import { ref, watch } from 'vue'
const user = ref({ name: '张三', age: 20 })

// 错误:监听不到age的变化
watch(user, (newVal) => {
  console.log('用户信息变了', newVal)
})

const changeAge = () => {
  user.value.age = 25 // 仅修改内部属性,不触发监听
}
</script>

避坑方案

根据 Vue 版本选择正确的监听方式:

  1. Vue3 监听 ref 包裹的对象:开启深度监听

    vue

    watch(user, (newVal) => {
      console.log('用户信息变了', newVal)
    }, { deep: true }) // 开启深度监听
    
  2. 精准监听单个属性:用函数返回值的方式,性能更优

    vue

    // 只监听age变化,无需深度监听
    watch(() => user.value.age, (newAge) => {
      console.log('年龄变了', newAge)
    })
    

最后总结

Vue 这些易忽略的知识点,本质上都是对底层原理理解不透彻导致的。很多时候我们只顾着实现功能,却忽略了这些细节,等到项目上线出现 bug 才追悔莫及。

以上 8 个知识点,建议结合代码逐个实操验证。如果本文帮你避开了坑,欢迎点赞收藏,也可以在评论区分享你踩过的 Vue 神坑,一起避雷成长!💪

Vue组件通信不再难!这8种方式让你彻底搞懂父子兄弟传值

2025年11月11日 07:29
你是不是经常遇到这样的场景?父组件的数据要传给子组件,子组件的事件要通知父组件,兄弟组件之间要共享状态...每次写Vue组件通信都觉得头大,不知道用哪种方式最合适? 别担心!今天我就带你彻底搞懂Vue
昨天以前首页

Vue 3 超强二维码识别:多区域/多尺度扫描 + 高级图像处理

作者 鹏北海
2025年11月10日 16:07

Vue 3 超强二维码识别:多区域/多尺度扫描 + 高级图像处理

在前端项目里做二维码识别,经常会遇到“背景复杂识别难”“二维码很小识别率低”“识别慢”的痛点。本文给大家介绍一个基于 Vue 3 的二维码识别工具库 —— vue-qrcode-scanner,主打“识别稳、速度快、接入简单”。

  • 支持多区域/多尺度扫描,优先命中高概率区域,提升首识别速度
  • 内置多种图像预处理:OTSU、自适应阈值、锐化、对比度拉伸,复杂背景也能顶住
  • 提供 Vue Composable API + 工具函数两套用法
  • TypeScript 全量类型,开发体验友好

开源地址与安装方式见文末,欢迎 Star 与反馈问题。

✨ 功能亮点

  • Vue 3 Composable:使用 Composition API,接入成本低
  • 多区域扫描:优先常见位置(如右下角)+ 滑动窗口策略
  • 多尺度扫描:自动在不同缩放级别尝试识别
  • 自动定位:返回二维码位置坐标,可视化标记更方便
  • 高级图像处理:OTSU、自适应阈值、锐化、对比度拉伸
  • 零依赖:除 Vue 以外无额外依赖(二维码识别算法使用 jsQR
  • TypeScript 支持:完整类型定义,二次开发舒适

📦 安装

npm install vue-qrcode-scanner
# 或
yarn add vue-qrcode-scanner
# 或
pnpm add vue-qrcode-scanner

识别二维码需要 jsQR 算法库,请一并安装:

npm install jsqr

🚀 快速开始(Composable 用法)

最简集成方式:直接在组件里调用 useQRCodeScanner

<template>
  <div>
    <input type="file" @change="handleFileSelect" accept="image/*" />
    <button @click="parseQRCode" :disabled="isLoading">
      {{ isLoading ? "解析中..." : "解析二维码" }}
    </button>

    <!-- 可选:Canvas 用于预览/辅助处理 -->
    <canvas ref="canvas" style="display: none"></canvas>

    <div v-if="resultMessage" :class="resultClass">
      <div v-html="resultMessage"></div>
    </div>
  </div>
</template>

<script setup>
import { ref } from "vue";
import { useQRCodeScanner } from "vue-qrcode-scanner/composables";

const selectedFile = ref(null);

const {
  resultMessage,
  isLoading,
  qrCode,
  canvas,
  resultClass,
  parseQRFromFile,
  clearResult,
} = useQRCodeScanner();

const handleFileSelect = (event) => {
  selectedFile.value = event.target.files[0];
};

const parseQRCode = async () => {
  if (selectedFile.value) {
    await parseQRFromFile(selectedFile.value);
  }
};
</script>

🌐 从 URL 解析

import { useQRCodeScanner } from "vue-qrcode-scanner/composables";

const { parseQRFromUrl } = useQRCodeScanner();

const code = await parseQRFromUrl("https://example.com/qrcode.png");
if (code) {
  console.log("二维码内容:", code.data);
}

🧩 高级用法(直接使用工具函数)

你也可以跳过 Composable,直接使用底层的图像处理与扫描工具:

import { imageProcessors, qrScanner } from "vue-qrcode-scanner";

// 1) 图像预处理(灰度化、OTSU、自适应阈值、锐化、对比度拉伸等)
const imageData = ctx.getImageData(0, 0, width, height);
const processed = imageProcessors.preprocessImage(imageData);

// 2) 多区域/多尺度扫描
const code = qrScanner.scanRegions(ctx, width, height);
if (code) {
  console.log("二维码内容:", code.data);
  console.log("位置:", code.location);
}

🛠 API 摘要

Composable: useQRCodeScanner()

  • 响应式状态:resultMessageisLoadingqrCodecanvasresultClass
  • 方法:
    • parseQRFromFile(file: File): Promise<QRCode | null>
    • parseQRFromUrl(url: string): Promise<QRCode | null>
    • clearResult(): void
    • showCanvasPreview(): void
    • hideCanvasPreview(): void

工具函数: imageProcessors

  • grayscale(imageData: ImageData): GrayData
  • otsuThreshold(grayData: Uint8ClampedArray): number
  • adaptiveThreshold(grayData, width, height, blockSize?, C?): Uint8ClampedArray
  • sharpen(grayData, width, height): Uint8ClampedArray
  • contrastStretch(grayData, minPercent?, maxPercent?): Uint8ClampedArray
  • preprocessImage(imageData: ImageData): ProcessedImage[]

工具函数: qrScanner

  • tryDecodeQR(imageData: ImageData): QRCode | null
  • scanRegions(ctx, imgWidth, imgHeight): QRCode | null
  • scanMultiScale(ctx, canvasElement, imgWidth, imgHeight): QRCode | null
  • adjustCodeLocation(code, offsetX, offsetY): QRCode
  • cropImageRegion(ctx, x, y, width, height): ImageData

类型定义(节选)

interface QRCode {
  data: string;
  format?: string;
  location?: QRCodeLocation;
  regionName?: string;
  preprocessMethod?: string;
  scale?: number;
}

interface QRCodeLocation {
  topLeftCorner: { x: number; y: number };
  topRightCorner: { x: number; y: number };
  bottomLeftCorner: { x: number; y: number };
  bottomRightCorner: { x: number; y: number };
}

⚠️ 注意事项 & 实战经验

  1. jsQR 为解析核心库,请确保已安装并正确引入
  2. 浏览器需支持 Canvas API;跨域图片请确保 CORS 允许,否则无法读取像素
  3. 大尺寸图片建议先等比压缩到合适尺寸(如最长边不超过 2000px)以提升速度
  4. 复杂背景下建议多尝试预处理组合(库内已内置多策略自动尝试)
  5. 如果需要在 UI 中高亮二维码位置,可结合返回的 location 四点坐标绘制

可视化大屏适配方案:用 Tailwind CSS 直接写设计稿像素值

作者 lemonboy
2025年11月9日 23:30

可视化大屏适配方案:用 Tailwind CSS 直接写设计稿像素值

前言

最近在做一个数据可视化大屏项目,设计稿是 1920×1080 的。开发的时候遇到一个很头疼的问题:Tailwind CSS 没办法针对单个属性做 px 转 vh 或者 vw

比如设计稿上写的是 width: 400px,我需要手动算成 width: 20.833vw(400/1920*100)。这还不算完,如果要做响应式适配,不同分辨率又要重新算一遍,代码里一堆小数,根本不知道对应设计稿的哪个值。

为了解决这个问题,我写了一个 Tailwind CSS 插件 tailwindcss-px-to-viewport,可以自动将 px 转 vh、vw。用了一段时间,发现效果还不错,分享给大家。

痛点

在做大屏项目的时候,你是不是也遇到过这些情况:

  1. 手动换算太麻烦:设计稿给的是 400px,你得算 400/1920*100 = 20.833vw
  2. 代码可读性差:代码里写的是 20.833vw,根本不知道设计稿上对应的是多少
  3. 适配成本高:换个分辨率,又要重新算一遍
  4. 容易出错:算错了或者写错了,调试起来很麻烦

解决方案

这个插件的核心思路很简单:你直接用 Tailwind 写设计稿的像素值,插件自动帮你转成 vh/vw

效果演示

先看个实际效果,下面这个 GIF 展示了同一个大屏在不同分辨率下的适配:

演示gif 可以看到,无论屏幕是 1920×1080 还是 3840×2160,布局都能自动适配,而且代码里写的都是设计稿的原始像素值。

使用方法

安装

npm install tailwindcss-px-to-viewport --save-dev

配置

tailwind.config.js 中添加插件:

// tailwind.config.js
import pxToViewport from 'tailwindcss-px-to-viewport'

export default {
  theme: {
    extend: {
      pxToViewPort: {
        // 基准视口配置
        PresetScreen: {
          width: 1920, // 默认设计稿宽度(单位:px)
          height: 1080, // 默认设计稿高度(单位:px)
        },
        // 自定义扩展规则(可选)
        utilities: {
          // 在此添加自定义转换规则
        }
      },
    },
  },
  plugins: [
    pxToViewport() // 启用插件
  ],
}

语法

  • pw- 前缀:转换为 vw(基于宽度)
  • ph- 前缀:转换为 vh(基于高度)

如果要将 width 的 px 转 vw,使用 pw-w-[100];如果要将 height 的 px 转 vh,使用 ph-h-[100]

实际案例

之前:手动换算

<template>
  <!-- 设计稿:宽度 400px,高度 300px,上边距 20px -->
  <div style="width: 20.833vw; height: 27.778vh; margin-top: 1.852vh;">
    <!-- 这些数字怎么来的?400/1920*100 = 20.833... 算起来太麻烦了 -->
  </div>
</template>

现在:直接写设计稿的值

<template>
  <!-- 设计稿:宽度 400px,高度 300px,上边距 20px -->
  <div class="pw-w-[400] ph-h-[300] ph-mt-[20]">
    <!-- 就这么简单,直接写 400、300、20,插件帮你转 -->
  </div>
</template>

大屏项目示例

假设设计稿是这样的:

标题区域:高度 60px,左右内边距 40px,上下内边距 20px
内容区域:宽度 1800px,高度 900px,左右外边距 60px
字体大小:18px

用这个插件,代码就是:

<template>
  <div class="relative pw-w-[1920] ph-h-[1080]">
    <!-- 标题区域 -->
    <div class="ph-h-[60] pw-px-[40] ph-py-[20]">
      <h1 class="pw-text-[32] ph-leading-[40]">数据大屏</h1>
    </div>
  
    <!-- 内容区域 -->
    <div class="pw-w-[1800] ph-h-[900] pw-mx-[60] ph-mt-[20]">
      <!-- 图表组件 -->
      <div class="pw-w-[800] ph-h-[400] pw-mr-[40]">
        <Chart />
      </div>
    </div>
  </div>
</template>

优势很明显:

  • 代码和设计稿一一对应,一眼就能看懂
  • 不用算来算去,写代码更快
  • 改设计稿尺寸?改个配置就行,代码不用动

支持的属性

插件支持所有常见的尺寸、间距、定位等属性:

  • 尺寸: w, h, min-w, max-w, min-h, max-h
  • 文字: text, leading, indent
  • 定位: top, right, bottom, left
  • 外边距: m, mt, mr, mb, ml, mx, my
  • 内边距: p, pt, pr, pb, pl, px, py

使用场景

这个插件特别适合:

  • 📊 数据大屏可视化 - 1920×1080、3840×2160 等大屏项目
  • 🖥️ 响应式 Web 应用 - 需要适配多种屏幕尺寸的项目
  • 📱 移动端适配 - 基于视口单位的移动端开发

总结

通过 tailwindcss-px-to-viewport,我们可以快速的将 px 转 vw 或者 vh,大大提升了开发效率。特别是做大屏项目的时候,不用再手动换算,直接写设计稿的像素值就行。

核心优势:

  • ✅ 代码和设计稿一一对应,可读性强
  • ✅ 自动适配不同分辨率
  • ✅ 配置简单,开箱即用

详细说明文档可以访问下面的 GitHub 仓库: 👉 GitHub 仓库


相关推荐:

一份实用的Vue3技术栈代码评审指南

作者 至简简
2025年11月8日 07:42

CSS

优先使用 **scoped** 

防止样式污染全局,每个组件样式必须局部化

错误示例:无作用域

<style>
.button {
  color: red;
}
</style>

 不加 scoped 会影响全局所有 .button

正确示例:使用 scoped

<style scoped>
.button {
  color: red;
}
</style>

限制嵌套层级 ≤ 3 层

嵌套超过 3 层说明选择器设计有问题,建议拆分样式或使用 BEM。

错误示例:嵌套过深(5 层)

.card {
  .header {
    .title {
      .icon {
        span {
          color: red;
        }
      }
    }
  }
}

正确方式是进行合理拆分

避免使用 !important

!important 会带来样式权重混乱,除非必要不推荐使用 !important

错误示例

.button {
  color: red !important;
}

.alert {
  display: none !important;
}

正确示例:提升选择器权重

/* 通过增加父级选择器权重覆盖 */
.container .button {
  color: red;
}

合理使用 v-deep 

在 Vue3 中,如果要覆盖子组件或第三方库的内部样式,必须使用 ::v-deep。禁止使用老版的 /deep/ 或 >>>,因为它们已废弃。同时要避免滥用 ::v-deep,只在必要时使用,并保持选择器短小。

 错误示例

<style scoped>
.child-component .btn {
  color: red;
}
</style>

正确示例

<style scoped>
::v-deep(.btn) {
  color: red;
}
</style>

优先使用 UnoCSS

因为项目中引入 UnoCSS,首选使用 UnoCSS。

错误示例

使用了传统的 CSS 类名来定义样式,而不是利用 UnoCSS 的原子化类。这违背了优先使用 UnoCSS 的原则。

<template>
  <div class="my-button">
    点击我
  </div>
</template>

<style scoped>
.my-button {
  background-color: #007bff;
  color: white;
  padding: 10px 20px;
  border-radius: 5px;
  cursor: pointer;
}
</style>

正确示例

充分利用了 UnoCSS 的原子化类来定义相同的样式

<template>
  <div class="bg-blue-500 text-white p-x-5 p-y-2 rounded-md cursor-pointer">
    点击我
  </div>
</template>

<style scoped>
/* 无需额外的 style 标签,因为样式已通过 UnoCSS 类名定义 */
</style>

JavaScript

变量与方法应采用统一的命名规范

命名应遵循语义清晰、风格一致、可读性高的原则,变量名体现数据类型/用途,方法名体现行为。团队建议统一小驼峰(camelCase) 风格,并避免无意义缩写或混用语言。

错误示例:变量命名不语义化

let a = true;
let b = [];
let c = "http://api.example.com";

正确示例如下

  1. 语义化命名

    let isActive = true;
    let userList: User[ ] = [ ];
    const API_BASE_URL = "http://api.example.com";
    
  2. 方法名包含动词

    function fetchData() { ... }
    function saveUser() { ... }
    function deleteUser() { ... }
    
  3. 布尔值变量以 is/has 开头

const isVisible = false;
const hasError = true;

 > 1. 布尔值遵循语法准确是前提 2 推荐用 has 开头

dev.to/michi/tips-…  参考写布尔值的工具

使用可选链

当访问对象的深层次属性时,如果中间某一级可能为 null 或 undefined,    (?.) 替代传统的逐层判断,代码更简洁且避免运行时异常。

错误示例

if (
  response &&
  response.data &&
  response.data.user &&
  response.data.user.profile
) {
  console.log(response.data.user.profile.name);
}

上面的代码示例中判断条件冗长且可读性差、容易漏掉某一级判断和难以维护

正确示例

const name = response?.data?.user?.profile?.name;
if (name) {
  console.log(name);
}

函数参数超过 3 个应封装成对象

当函数参数 超过 3 个 或存在多个相同类型的参数时,推荐将这些参数封装为一个对象。这样可以提升代码可读性、维护性,并支持命名参数调用,避免顺序错误。

错误示例:多个参数直接传递

function createUser(
  name: string,
  age: number,
  role: string,
  isActive: boolean,
  department: string
) {
  // 创建用户逻辑
}

createUser("Alice", 28, "admin", true, "Engineering");

正确示例

interface CreateUserOptions {
  name: string;
  age: number;
  role: string;
  isActive?: boolean;
  department?: string;
}

function createUser(options: CreateUserOptions) {
  const { name, age, role, isActive = true, department = "General" } = options;
  // 创建用户逻辑
}

createUser({
  name: "Alice",
  age: 28,
  role: "admin",
  department: "Engineering",
});

使用 ResizeObserver 替代 onResize

window.onresize 只能监听浏览器窗口尺寸变化,无法感知单个 DOM 元素尺寸变化。Vue3 项目应使用 ResizeObserver 监听任意 DOM 元素的尺寸变化,支持多元素、精准触发、性能更优。

错误示例

<script setup lang="ts">
const width = ref(0);

onMounted(() => {
  window.onresize = () => {
    const el = document.getElementById("container");
    width.value = el?.offsetWidth || 0;
  };
  window.onresize(); // 初始化
});
</script>

<template>
  <div id="container" style="width: 50%;">宽度:{{ width }}px</div>
</template>

问题

  • 无法感知父容器/内容变化,只能在窗口尺寸变化时触发。

  • 多组件绑定 window.onresize 时,回调容易互相覆盖。

  • 卸载时忘记移除监听,可能导致内存泄漏。

正确示例

<script setup lang="ts">
const elRef = ref<HTMLDivElement>();
const size = ref({ width: 0, height: 0 });

onMounted(() => {
  const observer = new ResizeObserver((entries) => {
    const rect = entries[0].contentRect;
    size.value.width = rect.width;
    size.value.height = rect.height;
  });
  observer.observe(elRef.value!);

  onUnmounted(() => observer.disconnect());
});
</script>

<template>
  <div ref="elRef" style="width: 50%;">
    宽度:{{ size.width }}px,高度:{{ size.height }}px
  </div>
</template>

TypeScript

避免在组件/逻辑中使用 any

在 Vite + TS 项目里,一旦滥用 any,类型检查形同虚设。要尽量用明确类型或 unknown(再做类型收窄)。

错误示例

function parseData(data: any) {
  return JSON.parse(data);
}

const user: any = getUser();
console.log(user.name);

正确示例

function parseData(data: unknown): Record<string, unknown> {
  if (typeof data === "string") {
    return JSON.parse(data);
  }
  throw new Error("Invalid data type");
}

interface User {
  name: string;
  age: number;
}
const user: User = getUser();
console.log(user.name);

目前有两种情况,

  1. stores 中没有写类型 (旧的不补类型,新的 stores 补类型) 新接口,新枚举,新常量

使用 enum 避免硬编码

所有固定集合值(角色、状态、方向等)必须使用 TypeScript 的 enum 定义,禁止使用字符串字面量或硬编码。

错误示例:硬编码字符串

if (user.role === 'admin') { ... }
if (status === 'PENDING') { ... }

正确示例:使用 enum

enum UserRole {
  Admin = 'admin',
  User = 'user',
  Guest = 'guest'
}

enum OrderStatus {
  Pending = 'PENDING',
  Shipped = 'SHIPPED',
  Delivered = 'DELIVERED'
}

if (user.role === UserRole.Admin) { ... }
if (status === OrderStatus.Pending) { ... }

Props、Emits 必须类型化

在 Vue3 的 SFC 中,defineProps 和 defineEmits 必须声明类型。

错误示例

defineProps(['title', 'count'])
defineEmits(['update'])

正确示例

interface Props {
  title: string
  count: number
}

interface Emits {
  (e: 'update', value: number): void
}

const props = defineProps<Props>()
const emit = defineEmits<Emits>()

3.3 以上有另一种方式

泛型必须具备边界约束

使用泛型时必须加上约束,防止过宽的类型导致不安全操作。

错误示例

function getValue<T>(obj: T, key: string) {
  return obj[key]
}

正确示例

function getValue<T extends object, K extends keyof T>(obj: T, key: K): T[K] {
  return obj[key]
}

组合式 API 必须有返回值类型

composables API 应该明确返回值类型,方便调用处类型推断。

错误示例

export function useUser() {
  const user = ref<User>()
  return { user }
}

正确示例

export function useUser(): { user: Ref<User> } {
  const user = ref<User>()
  return { user }
}

Vue3

不要在 defineProps() 里混用类型和 runtime 校验

Vue3 允许 defineProps() 使用 runtime 声明和类型声明,但二者混用易出 bug。推荐统一使用 泛型声明类型。

错误示例

<script setup lang="ts">
defineProps({
  title: String,
});
interface Props {
  title: string;
}
</script>

正确示例

<script setup lang="ts">
interface Props {
  title: string;
}
const props = defineProps<Props>();
</script>

类型声明统一放在 types 文件夹或模块中

全局类型或接口建议集中管理,避免散落在组件里难以维护。

错误示例

// 在多个组件里重复定义 interface User { name: string; age: number }

正确示例

src/types/user.d.ts
export interface User { name: string age: number }

在模板中使用类型提示

通过 defineExpose 和 defineEmits 的泛型参数在模板中获得类型提示。

错误示例

<template>
  <button @click="emit('save', 123)">Save</button>
</template>

<script setup lang="ts">
const emit = defineEmits(["save"]);
</script>

正确示例

<script setup lang="ts">
const emit = defineEmits<{
  (e: "save", id: number): void;
}>();
</script>

优先使用 <script setup> 而不是 defineComponent

Vue 3 的 <script setup> 更简洁、性能更好(编译优化),避免不必要的模板变量暴露。

错误示例

<script lang="ts">
import { defineComponent, ref } from "vue";

export default defineComponent({
  setup() {
    const count = ref(0);
    return { count };
  },
});
</script>

正确示例

<script setup lang="ts">
import { ref } from "vue";

const count = ref(0);
</script>

在模板中避免复杂逻辑表达式

模板里只做展示,不要做复杂逻辑,逻辑应移到计算属性或方法。

错误示例

<template>
  <div>
    {{
      users
        .filter((u) => u.age > 18)
        .map((u) => u.name)
        .join(", ")
    }}
  </div>
</template>

正确示例

<script setup lang="ts">
const adultNames = computed(() =>
  users.value
    .filter((u) => u.age > 18)
    .map((u) => u.name)
    .join(", ")
);
</script>

<template>
  <div>{{ adultNames }}</div>
</template>

事件名统一使用 kebab-case

Vue 3 推荐自定义事件名用 kebab-case,避免与 DOM 属性冲突。

错误示例

<ChildComponent @saveData="handleSave" />

正确示例

<ChildComponent @save-data="handleSave" />

组件通信避免滥用 $emit,优先使用 props + v-model

小型数据通信用 props/v-model,大型数据或频繁通信建议使用 Pinia/Composable。

错误示例

<ChildComponent @updateValue="parentValue = $event" />

正确示例

<ChildComponent v-model="parentValue" />

避免复杂嵌套三元运算

三元表达式适合简单条件切换,若逻辑复杂或嵌套,应使用 if-else、computed 或方法代替。 在模板中,复杂三元表达式严重降低可读性,且容易遗漏分支,Review 时应强制重构

错误示例

<template>
  <div>
    {{ status === "loading" ? "加载中" : status === "error" ? "错误" : "完成" }}
  </div>
</template>

正确示例

<script setup lang="ts">
const statusText = computed(() => {
  if (status.value === "loading") return "加载中";
  if (status.value === "error") return "错误";
  return "完成";
});
</script>

<template>
  <div>{{ statusText }}</div>
</template>

定时器必须在卸载时清理

在 Vue 组件中使用 setInterval、setTimeout、requestAnimationFrame 等定时器,必须在组件卸载(onUnmounted)时清理,否则会导致内存泄漏或意外触发逻辑

错误示例

<script setup lang="ts">
onMounted(() => {
  setInterval(() => {
    console.log("轮询接口");
  }, 1000);
});
</script>

正确示例

<script setup lang="ts">
let timer: ReturnType<typeof setInterval>;

onMounted(() => {
  timer = setInterval(() => {
    console.log("轮询接口");
  }, 1000);
});

onUnmounted(() => {
  clearInterval(timer);
});
</script>

IO(API 请求、文件处理等)必须做错误处理

网络请求(fetch/axios)、文件操作等 IO 行为容易失败,必须捕获异常并反馈用户,防止应用无响应或白屏

错误示例

const fetchData = async () => {
  const res = await fetch("/api/data");
  const data = await res.json();
  console.log(data);
};

正确示例

const fetchData = async () => {
  try {
    const res = await fetch("/api/data");
    if (!res.ok) throw new Error("请求失败");
    const data = await res.json();
    console.log(data);
  } catch (err) {
    console.error("数据请求错误:", err);
    alert("网络错误,请稍后重试");
  }
};

避免数据竞态(Race Condition)

当组件内多次发起异步请求或副作用操作(如用户快速切换选项),后发出的请求可能比先发出的请求先返回,导致数据状态错乱。必须通过请求标记、AbortController 或最新响应检查防止。

错误示例 具体场景:用户快速切换 Item 1 → Item 2 → Item 1,可能 Item 1 的旧请求最后返回,把数据覆盖成错误值。

<script setup lang="ts">
const selectedId = ref(1);
const data = ref(null);

watch(selectedId, async (id) => {
  const res = await fetch(`/api/item/${id}`);
  data.value = await res.json();
});
</script>

<template>
  <select v-model="selectedId">
    <option :value="1">Item 1</option>
    <option :value="2">Item 2</option>
  </select>
  <div>{{ data }}</div>
</template>

解决思路

正确示例 1:使用请求标记(Token)

<script setup lang="ts">
const selectedId = ref(1);
const data = ref(null);
let requestToken = 0;

watch(selectedId, async (id) => {
  const token = ++requestToken;
  const res = await fetch(`/api/item/${id}`);
  if (token !== requestToken) return; // 旧请求,丢弃
  data.value = await res.json();
});
</script>

正确示例 2:使用 AbortController

<script setup lang="ts">
const selectedId = ref(1);
const data = ref(null);
let controller: AbortController;

watch(selectedId, async (id) => {
  controller?.abort(); // 中断上一个请求
  controller = new AbortController();

  try {
    const res = await fetch(`/api/item/${id}`, { signal: controller.signal });
    data.value = await res.json();
  } catch (err) {
    if (err.name !== "AbortError") console.error(err);
  }
});
</script>

正确示例 3:封装 Composable,统一竞态处理

// composables/useSafeFetch.ts
export function useSafeFetch() {
  let controller: AbortController;

  return async function safeFetch(url: string) {
    controller?.abort();
    controller = new AbortController();
    const res = await fetch(url, { signal: controller.signal });
    return res.json();
  };
}
<script setup lang="ts">
const { safeFetch } = useSafeFetch();
const data = ref(null);

watch(selectedId, async (id) => {
  data.value = await safeFetch(`/api/item/${id}`);
});
</script>

列表渲染中不推荐使用索引作为 key

Vue 的虚拟 DOM 需要依赖 key 来准确地跟踪节点身份,保证列表渲染的高效与正确。**key** 必须唯一且稳定,通常来自数据的唯一标识字段(如数据库 ID)。避免使用数组索引 **index** 作为 **key**,除非数据列表静态且无增删排序需求

错误示例:使用索引作为 key

<template>
  <ul>
    <li v-for="(item, index) in items" :key="index">
      {{ item.name }}
    </li>
  </ul>
</template>

正确示例:使用稳定唯一标识作为 key

<template>
  <ul>
    <li v-for="item in items" :key="item.id">
      {{ item.name }}
    </li>
  </ul>
</template>

国际化

  1. 代码中的文案一定要做国际化处理 (比如中文正则表达式搜索检查)

  2. 国际化后的文案由 PM 提供,PM 不提供,使用 ChatGPT/Cursor 处理后与 PM 一起校对(拿不准找 Perry )

  3. 标点符号与语言对应,比如英文中不能出现中文括号

  4. 新增的国际化内容设置独立命令空间或者全文检索,避免 key 冲突

  5. 国际化内容的 key 是英文短语,不能是中文 

  6. PR 的 Code Review 中涉及国际化内容必须重点 review

 正确示例

export default {
'Administrator has enabled Multi-Factor Authentication (MFA)': 'El administrador ha habilitado la autenticación de múltiples factores (MFA)',
  'Open your app store': 'Abre tu tienda de aplicaciones',
};

 在组件中这样使用

<li>{{ t('Open your app store') }}</li>

Vue 组件设计

统一组件命名 / 文件命名策略

统一组件名采用 PascalCase(或一致 kebab-case),基础组件保留 Base 前缀,名称应全拼避免缩写,提高可维护性

错误示例

components/
  myComp.vue
  btn.vue

正确示例

components/
  MyComponent.vue
  BaseButton.vue

在组件中这样使用

<BaseButton/>

如果是 element-plus  组件库,可以使用如下的使用方式

<el-button/>

统一文件夹(目录)命名规范

项目中的所有目录名称必须遵循统一的命名风格,确保路径清晰、可预测、跨平台无大小写冲突。

错误示例:目录命名混乱

components/
  UserProfile/
  loginForm/
  Account_details/
  auth/

正确示例:统一 kebab-case

components/
  user-profile/
  login-form/
  account-details/
  auth/

TS 文件名命名

项目中的 TS 文件命名应该是小驼峰格式

错误示例

user-list.ts

 正确示例

userList.ts

组件的状态与 UI 分离

在 Vue3 组件开发中,所有数据处理逻辑(如 API 请求、数据格式化、状态管理等)应从 UI 层(模板 & 样式)中分离,放入 Composable、Store、Utils。模板只负责展示,逻辑放在单独模块便于测试、复用和维护。

错误示例

<script setup lang="ts">
import { ref, onMounted } from "vue";

const users = ref([]);
const loading = ref(false);
const error = ref("");

onMounted(async () => {
  loading.value = true;
  try {
    const res = await fetch("/api/users");
    users.value = await res.json();
  } catch (e) {
    error.value = "加载用户失败";
  } finally {
    loading.value = false;
  }
});

const formatName = (user) => `${user.firstName} ${user.lastName}`;
</script>

<template>
  <div v-if="loading">加载中...</div>
  <div v-else-if="error">{{ error }}</div>
  <ul v-else>
    <li v-for="user in users" :key="user.id">
      {{ formatName(user) }}
    </li>
  </ul>
</template>

上面的示例中存在的问题

  • API 请求逻辑、数据状态和格式化函数都在组件里

  • 组件职责太多:UI + 业务逻辑 + 状态管理

  • 无法复用 fetchUsers 和 formatName

正确示例 - 数据逻辑分离到 Composable

composables/useUsers.ts

import { ref } from "vue";

export function useUsers() {
  const users = ref([]);
  const loading = ref(false);
  const error = ref("");

  const fetchUsers = async () => {
    loading.value = true;
    try {
      const res = await fetch("/api/users");
      users.value = await res.json();
    } catch (e) {
      error.value = "加载用户失败";
    } finally {
      loading.value = false;
    }
  };

  const formatName = (user) => `${user.firstName} ${user.lastName}`;

  return { users, loading, error, fetchUsers, formatName };
}

UserList.vue

<script setup lang="ts">
import { onMounted } from "vue";
import { useUsers } from "@/composables/useUsers";

const { users, loading, error, fetchUsers, formatName } = useUsers();

onMounted(fetchUsers);
</script>

<template>
  <div v-if="loading">加载中...</div>
  <div v-else-if="error">{{ error }}</div>
  <ul v-else>
    <li v-for="user in users" :key="user.id">
      {{ formatName(user) }}
    </li>
  </ul>
</template>

正确的案例中,UI 专注展示,逻辑由 useUsers 管理、useUsers 可被其他组件复用、只需要测试 useUsers 方法就行

UI组件 vs 业务组件

UI组件(Button, Modal, Table):无业务逻辑,仅负责样式和交互

业务组件(UserList, OrderForm):封装具体业务逻辑,复用 UI 组件

错误示例:业务逻辑写在 UI 组件

<!-- Button.vue -->
<script setup>
const handleSaveUser = async () => {
  await api.saveUser()
}
</script>

<template>
  <button @click="handleSaveUser">保存</button>
</template>

正确示例:UI 组件尽量保证纯组件

<!-- Button.vue -->
<template>
  <button><slot /></button>
</template>

<!-- UserForm.vue -->
<Button @click="saveUser">保存</Button>

在写业务组件的时候,利用Composition API 分离逻辑,把 API 调用、数据处理抽离到 composable 中

避免直接操作 DOM

除非必要尽量不要使用 document.querySelector 等直接操作 DOM

错误示例

onMounted(() => {
  const el = document.querySelector('.btn')
  el?.addEventListener('click', () => { ... })
})

正确示例

<template>
  <button @click="handleClick" class="btn">Click</button>
</template>

<script setup lang="ts">
function handleClick() {
  // 处理逻辑
}
</script>

单元测试

1. 单元测试应覆盖核心业务逻辑,避免测试无意义的渲染细节

测试应聚焦于组件的行为和业务逻辑,而非仅仅验证静态的 DOM 结构,避免脆弱且维护成本高的测试。

错误示例

// 测试仅验证 DOM 具体标签和类名,DOM 结构细节变动即破坏测试
test('renders exact button markup', () => {
  const wrapper = mount(MyButton)
  expect(wrapper.html()).toBe('<button class="btn primary">Submit</button>')
})

正确示例

// 测试按钮是否存在且包含正确文本,关注业务效果而非具体标签细节
test('renders submit button', () => {
  const wrapper = mount(MyButton)
  const button = wrapper.find('button')
  expect(button.exists()).toBe(true)
  expect(button.text()).toBe('Submit')
})


2. 使用 Vue Test Utils 的异步渲染工具时,要正确等待 nextTick

Vue3 组件中很多行为是异步更新的,测试中操作后必须调用 await nextTick() 或使用 flushPromises() 等方法,确保断言是在 DOM 更新完成后进行。

错误示例

test('click increments count', () => {
  const wrapper = mount(Counter)
  wrapper.find('button').trigger('click')
  expect(wrapper.text()).toContain('Count: 1') // 断言过早,失败
})

正确示例

import { nextTick } from 'vue'

test('click increments count', async () => {
  const wrapper = mount(Counter)
  await wrapper.find('button').trigger('click')
  await nextTick()
  expect(wrapper.text()).toContain('Count: 1')
})


3. 事件触发测试必须确保事件正确被捕获并处理

测试组件自定义事件或原生事件时,需确保事件被正确监听,并使用 emitted() 方法断言事件触发,避免事件未触发测试通过的假象。

错误示例

test('emits submit event', () => {
  const wrapper = mount(FormComponent)
  wrapper.find('form').trigger('submit')
  expect(wrapper.emitted('submit')).toBeTruthy() // 可能事件未触发,但断言粗略
})

正确示例

test('emits submit event once', async () => {
  const wrapper = mount(FormComponent)
  await wrapper.find('form').trigger('submit.prevent')
  const submitEvents = wrapper.emitted('submit')
  expect(submitEvents).toHaveLength(1)
})


4. 不要在测试中硬编码组件内部状态,尽量从外部输入和输出测试

单元测试应以组件的公开接口(props、事件)为测试点,避免直接访问或修改组件内部私有数据,保持测试的稳健性和解耦。

错误示例

test('increments count internally', () => {
  const wrapper = mount(Counter)
  wrapper.vm.count = 5
  wrapper.vm.increment()
  expect(wrapper.vm.count).toBe(6) // 依赖内部状态
})

正确示例

test('increments count via user interaction', async () => {
  const wrapper = mount(Counter)
  await wrapper.find('button.increment').trigger('click')
  expect(wrapper.text()).toContain('Count: 1')
})


5. 避免在测试中使用复杂的真实 API 请求,应使用 Mock 或 Stub

测试时不应依赖外部接口的真实请求,推荐使用 jest.mock、msw、sinon 等模拟数据,保证测试的独立性和稳定性。

错误示例

test('fetches data and renders', async () => {
  const wrapper = mount(DataComponent)
  await wrapper.vm.fetchData() // 真实请求导致测试不稳定
  expect(wrapper.text()).toContain('Data loaded')
})

正确示例

import axios from 'axios'
jest.mock('axios')

test('fetches data and renders', async () => {
  axios.get.mockResolvedValue({ data: { items: ['a', 'b'] } })
  const wrapper = mount(DataComponent)
  await wrapper.vm.fetchData()
  expect(wrapper.text()).toContain('a')
})


6. 组件依赖的异步行为应通过 Mock 异步函数进行控制

若组件依赖异步方法(如定时器、异步 API),应在测试中 Mock 这些异步行为,避免测试时间过长或不稳定。

错误示例

test('auto refresh updates data', async () => {
  const wrapper = mount(AutoRefresh)
  await new Promise(r => setTimeout(r, 5000)) // 测试过慢且不确定
  expect(wrapper.text()).toContain('Refreshed')
})

正确示例

jest.useFakeTimers()

test('auto refresh updates data', async () => {
  const wrapper = mount(AutoRefresh)
  jest.advanceTimersByTime(5000)
  await nextTick()
  expect(wrapper.text()).toContain('Refreshed')
  jest.useRealTimers()
})


7. 使用快照测试时应谨慎,避免大规模快照导致维护困难

快照测试适合对关键 UI 做稳定性检测,但不应滥用,避免包含无关紧要的 DOM 变动。

错误示例

test('renders full component snapshot', () => {
  const wrapper = mount(ComplexComponent)
  expect(wrapper.html()).toMatchSnapshot() // 快照过大,难维护
})

正确示例

test('renders header snapshot only', () => {
  const wrapper = mount(ComplexComponent)
  expect(wrapper.find('header').html()).toMatchSnapshot()
})


8. 单元测试中避免使用全局依赖,推荐注入依赖或使用 provide/inject Mock

Vue3 组件可能依赖全局插件或 provide/inject,测试时应 Mock 这些依赖,避免测试受全局状态影响。

错误示例

test('uses global i18n', () => {
  const wrapper = mount(ComponentUsingI18n)
  expect(wrapper.text()).toContain('Hello') // 依赖真实 i18n,环境复杂
})

正确示例

import { createI18n } from 'vue-i18n'

const i18n = createI18n({ locale: 'en', messages: { en: { hello: 'Hello' } } })

test('uses mocked i18n', () => {
  const wrapper = mount(ComponentUsingI18n, {
    global: { plugins: [i18n] }
  })
  expect(wrapper.text()).toContain('Hello')
})

🚀 手动改 500 个文件?不存在的!我用 AST 撸了个 Vue 国际化神器

作者 baozj
2025年11月9日 11:13

🚀 手动改 500 个文件?不存在的!我用 AST 撸了个 Vue 国际化神器

😱 起因:一个让人头皮发麻的需求

周一早上,产品经理笑眯眯地走过来:"小王啊,咱们这个项目要支持多语言了,你看看什么时候能搞定?"

我打开项目一看,好家伙,500+ 个 Vue 文件,里面到处都是硬编码的中文:

<h1>欢迎使用我们的系统</h1>
<button>点击提交</button>
const message = "操作成功"

按照传统做法,我需要:

  1. 打开每个文件
  2. 找到所有中文字符串
  3. 手动加上 $t()t() 包裹
  4. 把中文提取到配置文件里

粗略估算了一下,这 TM 得改到猴年马月!😭

作为一个合格的懒人程序员,我的第一反应是:

"这种重复劳动,能不能让机器来干?"

于是,我花了 n 天时间撸了个自动化工具:VueI18nify

剧透一下结果:原本预计 5 天的工作量,工具跑了 10 秒就搞定了 ✨

不过过程中也踩了不少坑,这篇文章就来聊聊我是怎么用 AST 解决这个问题的,以及那些让我抓狂的技术细节。

🎯 这玩意儿到底能干啥?

先上效果,一图胜千言!

这个工具能自动帮你:

  1. 🔍 批量扫描文件 - 递归遍历整个项目,.vue.js.ts 一个都不放过
  2. 🎨 智能包裹中文 - 自动给所有中文字符串套上 i18n 函数,该用 $t()$t(),该用 t()t()
  3. 📦 生成配置文件 - 把所有中文提取出来,整整齐齐地放进 JSON 文件

举个栗子 🌰,它会把这样的"原始代码":

<template>
  <div>
    <h1>欢迎使用</h1>
    <button @click="handleClick('点击了按钮')">点击我</button>
  </div>
</template>

<script>
export default {
  data() {
    return {
      message: '消息内容'
    }
  }
}
</script>

一键变身成这样的"国际化代码":

<template>
  <div>
    <h1>{{ t('欢迎使用') }}</h1>
    <button @click="handleClick(t('点击了按钮'))">{{ t('点击我') }}</button>
  </div>
</template>

<script>
export default {
  data() {
    return {
      message: $t('消息内容') // 注意这里用的是 $t()
    }
  }
}
</script>

同时还会贴心地生成一个 i18n-messages.json 配置文件:

{
  "欢迎使用": "欢迎使用",
  "点击了按钮": "点击了按钮",
  "点击我": "点击我",
  "消息内容": "消息内容"
}

💡 小细节:注意到了吗?模板里用的是 t(),script 里用的是 $t(),这可不是随便写的,该用啥用啥。

🤔 技术选型:正则?不,我选择 AST!

第一个想法:用正则表达式?

刚开始我也想过偷懒,直接用正则表达式匹配中文字符串,然后替换成 $t('xxx') 不就完事了?

写了两行代码后,我就放弃了...

为啥? 因为正则表达式在这个场景下就是个定时炸弹 💣:

// 这些情况正则表达式根本搞不定:

// 1. 注释里的中文不应该被替换
// 这是一个中文注释

// 2. 已经包裹过的不应该重复包裹
const msg = $t('已经包裹过了')

// 3. 字符串里的引号怎么处理?
const text = "他说:'你好'"

// 4. 模板字符串里的变量怎么办?
const greeting = `你好,${name}`

// 5. 嵌套的对象属性呢?
const obj = { title: '标题', desc: '描述' }

试了几次后,我发现用正则表达式就像拿菜刀做手术,根本不靠谱!

最终方案:AST 大法好!

既然正则不行,那就上AST(抽象语法树)!

什么是 AST?简单来说,就是把代码解析成一棵树,每个节点都有明确的类型和位置信息。就像给代码做了个 CT 扫描,啥都能看得一清二楚。

技术栈:

  • 🔧 Babel 全家桶 - 处理 JavaScript/TypeScript
    • @babel/parser - 把代码变成 AST
    • @babel/traverse - 遍历和修改 AST
    • @babel/generator - 把 AST 变回代码
  • 🎨 Vue Compiler - 处理 Vue 模板
    • @vue/compiler-dom - 解析 Vue 模板
  • 💪 TypeScript - 类型安全,写着放心

为什么 AST 这么香?

  1. 精准打击 - 只处理字符串字面量节点,注释、变量名啥的完全不会误伤
  2. 上下文感知 - 知道这个字符串是在模板里还是 script 里,该用 t() 还是 $t() 一清二楚
  3. 安全可靠 - 修改 AST 后重新生成代码,语法 100% 正确,不会出现括号不匹配之类的低级错误

🛠️ 核心实现:编译器三板斧

整个工具的架构其实很简单,就是经典的编译器三阶段:

Parser (解析) → Transformer (转换) → Generator (生成)

听起来很高大上?其实就是:读代码 → 改代码 → 写代码,就这么简单!

1️⃣ JavaScript/TypeScript 处理

对于 JS/TS 代码,主要搞定两种情况:

场景一:普通字符串
traverse(ast, {
  StringLiteral(path) {
    if (containsChinese(path.node.value)) {
      // 收集中文文本,后面要生成配置文件
      i18nCollector.add(path.node.value)

      // 检查是否已经被包裹过了,避免重复包裹
      if (isAlreadyWrappedInI18n(path)) {
        return // 已经包裹过了,跳过!
      }

      // 创建 $t() 函数调用节点
      const replaceNode = t.callExpression(t.identifier('$t'), [t.stringLiteral(path.node.value)])

      // 替换原来的节点
      path.replaceWith(replaceNode)
    }
  }
})

效果:

// 转换前
const message = '操作成功'

// 转换后
const message = $t('操作成功')
场景二:模板字符串 (这个有点坑!)

模板字符串是个大坑,因为里面可能有变量插值:

TemplateLiteral(path) {
  path.node.quasis.forEach((quasi) => {
    const text = quasi.value.raw
    if (containsChinese(text)) {
      // 将 `你好,${name}` 转换为 `${$t('你好,')}${name}`
      quasi.value.raw = `\${$t('${text.trim()}')}`
    }
  })
}

效果:

// 转换前
const greeting = `你好,${name}!欢迎使用`

// 转换后
const greeting = `${$t('你好,')}${name}${$t('!欢迎使用')}`

💡 踩坑记录:一开始我直接把整个模板字符串替换成 $t(\你好,${name}`)`,结果发现 i18n 不支持这种写法...后来才知道要把固定的文本部分提取出来单独包裹。

2️⃣ Vue 模板处理

Vue 模板比 JS 代码复杂多了,因为要处理各种节点类型。

场景一:文本节点

这个最简单,直接包裹就行:

const transformText = (node: TextNode): string => {
  const content = node.content
  if (containsChinese(content)) {
    i18nCollector.add(content.trim())

    // 检查是否已经包裹过了
    if (content.includes('t(')) {
      return content
    }

    // 包裹成 {{ t('xxx') }}
    return `{{ t('${content.trim()}') }}`
  }
  return content
}

效果:

<!-- 转换前 -->
<h1>欢迎使用</h1>

<!-- 转换后 -->
<h1>{{ t('欢迎使用') }}</h1>
场景二:属性节点

属性里的中文也要处理,而且要把普通属性改成动态绑定:

// 普通属性:placeholder="请输入"
// 转换为::placeholder="t('请输入')"

if (containsChinese(value)) {
  i18nCollector.add(value)
  return `:${attrName}="t('${value}')"` // 注意前面加了冒号!
}

效果:

<!-- 转换前 -->
<input placeholder="请输入用户名" />

<!-- 转换后 -->
<input :placeholder="t('请输入用户名')" />
场景三:事件处理器中的字符串
<!-- 转换前 -->
<button @click="handleClick('点击了按钮')">按钮</button>

<!-- 转换后 -->
<button @click="handleClick(t('点击了按钮'))">{{ t('按钮') }}</button>

这里需要解析事件处理器中的 JavaScript 表达式,找到字符串参数并替换。

实现方式:把事件处理器的表达式当成 JS 代码,用 Babel 处理一遍!

🎓 总结:

收获

这个项目虽然小,但让我对 AST 和编译原理有了更深的理解:

  1. AST 不是玄学 - 其实就是把代码变成树形结构,然后遍历修改,最后再变回代码
  2. 工具链很重要 - Babel 和 Vue Compiler 这些成熟的工具能省很多事
  3. 边界情况很多 - 看似简单的需求,实际实现起来要考虑各种边界情况
  4. 完成比完美重要 - 先做出能用的版本,再慢慢优化

项目地址: github.com/baozjj/VueI…

技术栈: TypeScript | Babel | AST | Vue Compiler

如果觉得有用,欢迎 Star ⭐️

《uni-app跨平台开发完全指南》- 05 - 基础组件使用

2025年11月8日 10:55

基础组件

欢迎回到《uni-app跨平台开发完全指南》系列!在之前的文章中,我们搭好了开发环境,了解了项目目录结构、Vue基础以及基本的样式,这一章节带大家了解基础组件如何使用。掌握了基础组件的使用技巧,就能独立拼装出应用的各个页面了!

一、 初识uni-app组件

在开始之前,先自问下什么是组件?

你可以把它理解为一个封装了结构(WXML)、样式(WXSS)和行为(JS)的、可复用的自定义标签。比如一个按钮、一个导航栏、一个商品卡片,都可以是组件。

uni-app的组件分为两类:

  1. 基础组件:框架内置的,如<view>, <text>, <image>等。这些是官方为我们准备好的标准组件。
  2. 自定义组件:开发者自己封装的,用于实现特定功能或UI的组件,可反复使用。

就是这些基础组件,它们遵循小程序规范,同时被映射到各端,是实现“一套代码,多端运行”的基础。

为了让大家对基础组件有个全面的认识,参考下面的知识脉络图:

graph TD
    A[uni-app 基础组件] --> B[视图容器类];
    A --> C[基础内容类];
    A --> D[表单类];
    A --> E[导航类];
    A --> F[自定义组件];

    B --> B1[View];
    B --> B2[Scroll-View];

    C --> C1[Text];
    C --> C2[Image];

    D --> D1[Button];
    D --> D2[Input];
    D --> D3[Checkbox/Radio];

    E --> E1[Navigator];

    F --> F1[创建];
    F --> F2[通信];
    F --> F3[生命周期];

接下来,我们详细介绍下这些内容。


二、 视图与内容:View、Text、Image

这三个组件是构建页面最基础、最核心的部分,几乎无处不在。

2.1 一切的容器:View

<view> 组件是一个视图容器。它相当于传统HTML中的 <div> 标签,是一个块级元素,主要用于布局和包裹其他内容。

核心特性:

  • 块级显示:默认独占一行。
  • 样式容器:通过为其添加classstyle,可以轻松实现Flex布局、Grid布局等。
  • 事件容器:可以绑定各种触摸事件,如@tap(点击)、@touchstart(触摸开始)等。

以一个简单的Flex布局为例:

<!-- 模板部分 -->
<template>
  <view class="container">
    <view class="header">我是头部</view>
    <view class="content">
      <view class="left-sidebar">左边栏</view>
      <view class="main-content">主内容区</view>
    </view>
    <view class="footer">我是底部</view>
  </view>
</template>

<style scoped>
/* 样式部分 */
.container {
  display: flex;
  flex-direction: column; /* 垂直排列 */
  height: 100vh; /* 满屏高度 */
}
.header, .footer {
  height: 50px;
  background-color: #007AFF;
  color: white;
  text-align: center;
  line-height: 50px; /* 垂直居中 */
}
.content {
  flex: 1; /* 占据剩余所有空间 */
  display: flex; /* 内部再启用Flex布局 */
}
.left-sidebar {
  width: 100px;
  background-color: #f0f0f0;
}
.main-content {
  flex: 1; /* 占据content区域的剩余空间 */
  background-color: #ffffff;
}
</style>

以上代码:

  • 我们通过多个<view>的嵌套,构建了一个经典的“上-中-下”布局。
  • 外层的.container使用flex-direction: column实现垂直排列。
  • 中间的.content自己也是一个Flex容器,实现了内部的水平排列。
  • flex: 1 是Flex布局的关键,表示弹性扩展,填满剩余空间。

小结一下View:

  • 它是布局的骨架,万物皆可<view>
  • 熟练掌握Flex布局,再复杂的UI也能用<view>拼出来。

2.2 Text

<text> 组件是一个文本容器。它相当于HTML中的 <span> 标签,是行内元素。最重要的特点是:只有 <text> 组件内部的文字才是可选中的、长按可以复制!

核心特性:

  • 行内显示:默认不会换行。
  • 文本专属:用于包裹文本,并对文本设置样式和事件。
  • 选择与复制:支持user-select属性控制文本是否可选。
  • 嵌套与富文本:内部可以嵌套,自身也支持部分HTML实体和富文本。

以一个文本样式与事件为例:

<template>
  <view>
    <!-- 普通的view里的文字无法长按复制 -->
    <view>这段文字在view里,无法长按复制。</view>
    
    <!-- text里的文字可以 -->
    <text user-select @tap="handleTextTap" class="my-text">
      这段文字在text里,可以长按复制!点击我也有反应。
      <text style="color: red; font-weight: bold;">我是嵌套的红色粗体文字</text>
    </text>
  </view>
</template>

<script>
export default {
  methods: {
    handleTextTap() {
      uni.showToast({
        title: '你点击了文字!',
        icon: 'none'
      });
    }
  }
}
</script>

<style>
.my-text {
  color: #333;
  font-size: 16px;
  /* 注意:text组件不支持设置宽高和margin-top/bottom,因为是行内元素 */
  /* 如果需要,可以设置 display: block 或 inline-block */
}
</style>

以上代码含义:

  • user-select属性开启了文本的可选状态。
  • <text>组件可以绑定@tap事件,而<view>里的纯文字不能。
  • 内部的<text>嵌套展示了如何对部分文字进行特殊样式处理。

Text使用小技巧:

  1. 何时用? 只要是涉及交互(点击、长按)或需要复制功能的文字,必须用<text>包裹。
  2. 样式注意:它是行内元素,设置宽高和垂直方向的margin/padding可能不生效,可通过display: block改变。
  3. 性能:避免深度嵌套,尤其是与富文本一起使用时。

2.3 Image

<image> 组件用于展示图片。它相当于一个增强版的HTML <img>标签,提供了更丰富的功能和更好的性能优化。

核心特性与原理:

  • 多种模式:通过mode属性控制图片的裁剪、缩放模式,这是它的灵魂所在
  • 懒加载lazy-load属性可以在页面滚动时延迟加载图片,提升性能。
  • 缓存与 headers:支持配置网络图片的缓存策略和请求头。

mode属性详解(非常重要!) mode属性决定了图片如何适应容器的宽高。我们来画个图理解一下:

stateDiagram-v2
    [*] --> ImageMode选择
    
    state ImageMode选择 {
        [*] --> 首要目标判断
        
        首要目标判断 --> 保持完整不裁剪: 选择
        首要目标判断 --> 保持比例不变形: 选择  
        首要目标判断 --> 固定尺寸裁剪: 选择
        
        保持完整不裁剪 --> scaleToFill: 直接进入
        scaleToFill : scaleToFill\n拉伸至填满,可能变形
        
        保持比例不变形 --> 适应方式判断
        适应方式判断 --> aspectFit: 完全显示
        适应方式判断 --> aspectFill: 填满容器
        
        aspectFit : aspectFit\n适应模式\n容器可能留空
        aspectFill : aspectFill\n填充模式\n图片可能被裁剪
        
        固定尺寸裁剪 --> 多种裁剪模式
        多种裁剪模式 : widthFix / top / bottom\n等裁剪模式
    }
    
    scaleToFill --> [*]
    aspectFit --> [*]
    aspectFill --> [*]
    多种裁剪模式 --> [*]

下面用一段代码来展示不同Mode的效果

<template>
  <view>
    <view class="image-demo">
      <text>scaleToFill (默认,拉伸):</text>
      <!-- 容器 200x100,图片会被拉伸 -->
      <image src="/static/logo.png" mode="scaleToFill" class="img-container"></image>
    </view>

    <view class="image-demo">
      <text>aspectFit (适应):</text>
      <!-- 图片完整显示,上下或左右留白 -->
      <image src="/static/logo.png" mode="aspectFit" class="img-container"></image>
    </view>

    <view class="image-demo">
      <text>aspectFill (填充):</text>
      <!-- 图片填满容器,但可能被裁剪 -->
      <image src="/static/logo.png" mode="aspectFill" class="img-container"></image>
    </view>

    <view class="image-demo">
      <text>widthFix (宽度固定,高度自适应):</text>
      <!-- 非常常用!高度会按比例自动计算 -->
      <image src="/static/logo.png" mode="widthFix" class="img-auto-height"></image>
    </view>
  </view>
</template>

<style>
.img-container {
  width: 200px;
  height: 100px; /* 固定高度的容器 */
  background-color: #eee; /* 用背景色看出aspectFit的留白 */
  border: 1px solid #ccc;
}
.img-auto-height {
  width: 200px;
  /* 不设置height,由图片根据widthFix模式自动计算 */
}
.image-demo {
  margin-bottom: 20rpx;
}
</style>

Image使用注意:

  1. 首选 widthFix:在需要图片自适应宽度(如商品详情图、文章配图)时,mode="widthFix" 是神器,无需计算高度。
  2. ** 必设宽高**:无论是直接设置还是通过父容器继承,必须让<image>有确定的宽高,否则可能显示异常。
  3. 加载失败处理:使用@error事件监听加载失败,并设置默认图。
    <image :src="avatarUrl" @error="onImageError" class="avatar"></image>
    
    onImageError() {
      this.avatarUrl = '/static/default-avatar.png'; // 替换为默认头像
    }
    
  4. 性能优化:对于列表图片,务必加上 lazy-load

三、 按钮与表单组件

应用不能只是展示,更需要与用户交互。

3.1 Button

<button> 组件用于捕获用户的点击操作。它功能强大,样式多样,甚至能直接调起系统的某些功能。

核心特性

  • 多种类型:通过type属性控制基础样式,如default(默认)、primary(主要)、warn(警告)。
  • 开放能力:通过open-type属性可以直接调起微信的获取用户信息、分享、客服等功能。
  • 样式自定义:虽然提供了默认样式,但可以通过hover-class等属性实现点击反馈,也可以通过CSS完全自定义。

用一段代码来展示各种按钮:

<template>
  <view class="button-group">
    <!-- 基础样式按钮 -->
    <button type="default">默认按钮</button>
    <button type="primary">主要按钮</button>
    <button type="warn">警告按钮</button>

    <!-- 禁用状态 -->
    <button :disabled="true" type="primary">被禁用的按钮</button>

    <!-- 加载状态 -->
    <button loading type="primary">加载中...</button>

    <!-- 获取用户信息 -->
    <button open-type="getUserInfo" @getuserinfo="onGetUserInfo">获取用户信息</button>

    <!-- 分享 -->
    <button open-type="share">分享</button>

    <!-- 自定义样式 - 使用 hover-class -->
    <button class="custom-btn" hover-class="custom-btn-hover">自定义按钮</button>
  </view>
</template>

<script>
export default {
  methods: {
    onGetUserInfo(e) {
      console.log('用户信息:', e.detail);
      // 在这里处理获取到的用户信息
    }
  }
}
</script>

<style>
.button-group button {
  margin-bottom: 10px; /* 给按钮之间加点间距 */
}
.custom-btn {
  background-color: #4CD964; /* 绿色背景 */
  color: white;
  border: none; /* 去除默认边框 */
  border-radius: 10px; /* 圆角 */
}
.custom-btn-hover {
  background-color: #2AC845; /*  hover时更深的绿色 */
}
</style>

Button要点:

  • open-type:这是uni-app和小程序生态打通的关键,让你能用一行代码实现复杂的原生功能。
  • 自定义样式:默认按钮样式可能不符合设计,记住一个原则:先重置,再定义。使用border: none; background: your-color;来覆盖默认样式。
  • 表单提交:在<form>标签内,<button>form-type属性可以指定为submitreset

3.2 表单组件 - Input, Checkbox, Radio, Picker...

表单用于收集用户输入。uni-app提供了一系列丰富的表单组件。

Input - 文本输入框

核心属性:

  • v-model:双向绑定输入值,最常用
  • type:输入框类型,如text, number, idcard, password等。
  • placeholder:占位符。
  • focus:自动获取焦点。
  • @confirm:点击完成按钮时触发。

下面写一个登录输入框:

<template>
  <view class="login-form">
    <input v-model="username" type="text" placeholder="请输入用户名" class="input-field" />
    <input v-model="password" type="password" placeholder="请输入密码" class="input-field" @confirm="onLogin" />
    <button type="primary" @tap="onLogin">登录</button>
  </view>
</template>

<script>
export default {
  data() {
    return {
      username: '',
      password: ''
    };
  },
  methods: {
    onLogin() {
      // 验证用户名和密码
      if (!this.username || !this.password) {
        uni.showToast({ title: '请填写完整', icon: 'none' });
        return;
      }
      console.log('登录信息:', this.username, this.password);
      // 发起登录请求...
    }
  }
}
</script>

<style>
.input-field {
  border: 1px solid #ddd;
  border-radius: 4px;
  padding: 10px;
  margin-bottom: 15px;
  height: 40px;
}
</style>

Checkbox 与 Radio - 选择与单选

这两个组件需要和<checkbox-group>, <radio-group>一起使用,来管理一组选项。

代码实战:选择兴趣爱好

<template>
  <view>
    <text>请选择你的兴趣爱好:</text>
    <checkbox-group @change="onHobbyChange">
      <label class="checkbox-label">
        <checkbox value="reading" :checked="true" /> 阅读
      </label>
      <label class="checkbox-label">
        <checkbox value="music" /> 音乐
      </label>
      <label class="checkbox-label">
        <checkbox value="sports" /> 运动
      </label>
    </checkbox-group>
    <view>已选:{{ selectedHobbies.join(', ') }}</view>

    <text>请选择性别:</text>
    <radio-group @change="onGenderChange">
      <label class="radio-label">
        <radio value="male" /></label>
      <label class="radio-label">
        <radio value="female" /></label>
    </radio-group>
    <view>已选:{{ selectedGender }}</view>
  </view>
</template>

<script>
export default {
  data() {
    return {
      selectedHobbies: ['reading'], // 默认选中阅读
      selectedGender: ''
    };
  },
  methods: {
    onHobbyChange(e) {
      // e.detail.value 是一个数组,包含所有被选中的checkbox的value
      this.selectedHobbies = e.detail.value;
      console.log('兴趣爱好变化:', e.detail.value);
    },
    onGenderChange(e) {
      // e.detail.value 是单个被选中的radio的value
      this.selectedGender = e.detail.value;
      console.log('性别变化:', e.detail.value);
    }
  }
}
</script>

<style>
.checkbox-label, .radio-label {
  display: block;
  margin: 5px 0;
}
</style>

表单组件使用技巧:

  1. 善用v-model:能够极大简化双向数据绑定的代码。
  2. 理解事件checkboxradio的change事件发生在组(group) 上,通过e.detail.value获取所有值。
  3. UI统一:原生组件样式在各端可能略有差异,对于要求高的场景,可以考虑使用UI库(如uView)的自定义表单组件。

四、 导航与容器组件

当应用内容变多,我们需要更好的方式来组织页面结构和实现页面跳转。

4.1 Navigator

<navigator> 组件是一个页面链接,用于在应用内跳转到指定页面。它相当于HTML中的 <a> 标签,但功能更丰富。

核心属性与跳转模式:

  • url必填,指定要跳转的页面路径。
  • open-type跳转类型,决定了跳转行为。
    • navigate:默认值,保留当前页面,跳转到新页面(可返回)。
    • redirect:关闭当前页面,跳转到新页面(不可返回)。
    • switchTab:跳转到tabBar页面,并关闭所有非tabBar页面。
    • reLaunch:关闭所有页面,打开到应用内的某个页面。
    • navigateBack:关闭当前页面,返回上一页面或多级页面。
  • delta:当open-typenavigateBack时有效,表示返回的层数。

为了更清晰地理解这几种跳转模式对页面栈的影响,我画了下面这张图:

mermaid-diagram-2025-11-08-094700.png

下面用代码实现一个简单的导航

<template>
  <view class="nav-demo">
    <!-- 普通跳转,可以返回 -->
    <navigator url="/pages/about/about" hover-class="navigator-hover">
      <button>关于我们(普通跳转)</button>
    </navigator>

    <!-- 重定向,无法返回 -->
    <navigator url="/pages/index/index" open-type="redirect">
      <button type="warn">回首页(重定向)</button>
    </navigator>

    <!-- 跳转到TabBar页面 -->
    <navigator url="/pages/tabbar/my/my" open-type="switchTab">
      <button type="primary">个人中心(Tab跳转)</button>
    </navigator>

    <!-- 返回上一页 -->
    <navigator open-type="navigateBack">
      <button>返回上一页</button>
    </navigator>
    <!-- 返回上两页 -->
    <navigator open-type="navigateBack" :delta="2">
      <button>返回上两页</button>
    </navigator>
  </view>
</template>

<style>
.nav-demo button {
  margin: 10rpx;
}
.navigator-hover {
  background-color: #f0f0f0; /* 点击时的反馈色 */
}
</style>

Navigator避坑:

  1. url路径:必须以/开头,在pages.json中定义。
  2. 跳转TabBar:必须使用open-type="switchTab",否则无效。
  3. 传参:可以在url后面拼接参数,如/pages/detail/detail?id=1&name=test,在目标页面的onLoad生命周期中通过options参数获取。
  4. 跳转限制:小程序中页面栈最多十层,注意使用redirect避免层级过深。

4.2 Scroll-View

<scroll-view> 是一个可滚动的视图容器。当内容超过容器高度(或宽度)时,提供滚动查看的能力。

核心特性:

  • 滚动方向:通过scroll-x(横向)和scroll-y(纵向)控制。
  • 滚动事件:可以监听@scroll事件,获取滚动位置。
  • 上拉加载/下拉刷新:通过@scrolltolower@scrolltoupper等事件模拟,但更推荐使用页面的onReachBottomonPullDownRefresh

代码实现一个横向滚动导航和纵向商品列表

<template>
  <view>
    <!-- 横向滚动导航 -->
    <scroll-view scroll-x class="horizontal-scroll">
      <view v-for="(item, index) in navList" :key="index" class="nav-item">
        {{ item.name }}
      </view>
    </scroll-view>

    <!-- 纵向滚动商品列表 -->
    <scroll-view scroll-y :style="{ height: scrollHeight + 'px' }" @scrolltolower="onLoadMore">
      <view v-for="(product, idx) in productList" :key="idx" class="product-item">
        <image :src="product.image" mode="aspectFill" class="product-img"></image>
        <text class="product-name">{{ product.name }}</text>
      </view>
      <view v-if="loading" class="loading-text">加载中...</view>
    </scroll-view>
  </view>
</template>

<script>
export default {
  data() {
    return {
      navList: [ /* ... 导航数据 ... */ ],
      productList: [ /* ... 商品数据 ... */ ],
      scrollHeight: 0,
      loading: false
    };
  },
  onLoad() {
    // 动态计算scroll-view的高度,使其充满屏幕剩余部分
    const sysInfo = uni.getSystemInfoSync();
    // 假设横向导航高度为50px,需要根据实际情况计算
    this.scrollHeight = sysInfo.windowHeight - 50;
  },
  methods: {
    onLoadMore() {
      // 加载更多
      if (this.loading) return;
      this.loading = true;
      console.log('开始加载更多数据...');
      // 请求数据
      setTimeout(() => {
        // ... 获取新数据并拼接到productList ...
        this.loading = false;
      }, 1000);
    }
  }
}
</script>

<style>
.horizontal-scroll {
  white-space: nowrap; /* 让子元素不换行 */
  width: 100%;
  background-color: #f7f7f7;
}
.nav-item {
  display: inline-block; /* 让子元素行内排列 */
  padding: 10px 20px;
  margin: 5px;
  background-color: #fff;
  border-radius: 15px;
}
.product-item {
  display: flex;
  padding: 10px;
  border-bottom: 1px solid #eee;
}
.product-img {
  width: 80px;
  height: 80px;
  border-radius: 5px;
}
.product-name {
  margin-left: 10px;
  align-self: center;
}
.loading-text {
  text-align: center;
  padding: 10px;
  color: #999;
}
</style>

Scroll-View使用心得:

  • 横向滚动:牢记两个CSS:容器white-space: nowrap;,子项display: inline-block;
  • 性能<scroll-view>内不适合放过多或过于复杂的子节点,尤其是图片,可能导致滚动卡顿。对于长列表,应使用官方的<list>组件或社区的长列表组件。
  • 高度问题:纵向滚动的<scroll-view>必须有一个固定的高度,否则会无法滚动。通常通过JS动态计算。

五、 自定义组件基础

当项目变得复杂,我们会发现很多UI模块或功能块在重复编写。这时,就该自定义组件了!它能将UI和功能封装起来,实现复用和解耦。

5.1 为什么要用自定义组件?

  1. 复用性:一次封装,到处使用。
  2. 可维护性:功能集中在一处,修改方便。
  3. 清晰性:将复杂页面拆分成多个组件,结构清晰,便于协作。

5.2 创建与使用一个自定义组件

让我们来封装一个简单的UserCard组件。

第一步:创建组件文件 在项目根目录创建components文件夹,然后在里面创建user-card/user-card.vue文件。uni-app会自动识别components目录下的组件。

第二步:编写组件模板、逻辑与样式

<!-- components/user-card/user-card.vue -->
<template>
  <view class="user-card" @tap="onCardClick">
    <image :src="avatarUrl" class="avatar" mode="aspectFill"></image>
    <view class="info">
      <text class="name">{{ name }}</text>
      <text class="bio">{{ bio }}</text>
    </view>
    <view class="badge" v-if="isVip">VIP</view>
  </view>
</template>

<script>
export default {
  // 声明组件的属性,外部传入的数据
  props: {
    avatarUrl: {
      type: String,
      default: '/static/default-avatar.png' 
    },
    name: {
      type: String,
      required: true 
    },
    bio: String, // 简写方式,只定义类型
    isVip: Boolean
  },
  // 组件内部数据
  data() {
    return {
      // 这里放组件自己的状态
    };
  },
  methods: {
    onCardClick() {
      // 触发一个自定义事件,通知父组件
      this.$emit('cardClick', { name: this.name });
      // 也可以在这里处理组件内部的逻辑
      uni.showToast({
        title: `点击了${this.name}的名片`,
        icon: 'none'
      });
    }
  }
}
</script>

<style scoped>
.user-card {
  display: flex;
  padding: 15px;
  background-color: #fff;
  border-radius: 8px;
  margin: 10px;
  position: relative;
  box-shadow: 0 2px 6px rgba(0,0,0,0.1);
}
.avatar {
  width: 50px;
  height: 50px;
  border-radius: 25px;
}
.info {
  display: flex;
  flex-direction: column;
  margin-left: 12px;
  justify-content: space-around;
}
.name {
  font-size: 16px;
  font-weight: bold;
}
.bio {
  font-size: 12px;
  color: #999;
}
.badge {
  position: absolute;
  top: 10px;
  right: 10px;
  background-color: #ffd700;
  color: #333;
  font-size: 10px;
  padding: 2px 6px;
  border-radius: 4px;
}
</style>

第三步:在页面中使用组件

<!-- pages/index/index.vue -->
<template>
  <view>
    <text>用户列表</text>
    <!-- 使用自定义组件 -->
    <!-- 1. 通过属性传递数据 -->
    <user-card 
      name="码小明" 
      bio="热爱编程" 
      :is-vip="true"
      avatar-url="/static/avatar1.jpg"
      @cardClick="onUserCardClick" <!-- 2. 监听子组件发出的自定义事件 -->
    />
    <user-card 
      name="产品经理小鱼儿" 
      bio="让世界更美好" 
      :is-vip="false"
      @cardClick="onUserCardClick"
    />
  </view>
</template>

<script>
// 2. 导入组件
// import UserCard from '@/components/user-card/user-card.vue';
export default {
  // 3. 注册组件
  // components: { UserCard },
  methods: {
    onUserCardClick(detail) {
      console.log('父组件收到了卡片的点击事件:', detail);
      // 这里可以处理跳转逻辑
      // uni.navigateTo({ url: '/pages/user/detail?name=' + detail.name });
    }
  }
}
</script>

5.3 核心概念:Props, Events, Slots

一个完整的自定义组件通信机制,主要围绕这三者展开。它们的关系可以用下图清晰地表示:

mermaid-diagram-2025-11-08-095516.png

  1. Props(属性)由外到内的数据流。父组件通过属性的方式将数据传递给子组件。子组件用props选项声明接收。
  2. Events(事件)由内到外的通信。子组件通过this.$emit('事件名', 数据)触发一个自定义事件,父组件通过v-on@来监听这个事件。
  3. Slots(插槽)内容分发。父组件可以将一段模板内容“插入”到子组件指定的位置。这极大地增强了组件的灵活性。

插槽(Slot)简单示例: 假设我们的UserCard组件,想在bio下面留一个区域给父组件自定义内容。

在子组件中:

<!-- user-card.vue -->
<view class="info">
  <text class="name">{{ name }}</text>
  <text class="bio">{{ bio }}</text>
  <!-- 默认插槽,父组件传入的内容会渲染在这里 -->
  <slot></slot>
  <!-- 具名插槽 -->
  <!-- <slot name="footer"></slot> -->
</view>

在父组件中:

<user-card name="小明" bio="...">
  <!-- 传入到默认插槽的内容 -->
  <view style="margin-top: 5px;">
    <button size="mini">关注</button>
  </view>
  <!-- 传入到具名插槽footer的内容 -->
  <!-- <template v-slot:footer> ... </template> -->
</user-card>

5.4 EasyCom

你可能会注意到,在上面的页面中,我们并没有importcomponents注册,但组件却正常使用了。这是因为uni-app的 easycom 规则。

规则:只要组件安装在项目的components目录下,并符合components/组件名称/组件名称.vue的目录结构,就可以不用手动引入和注册,直接在页面中使用。极大地提升了开发效率!


六、 内容总结

至此基本组件内容就介绍完了,又到了总结的时候了,本节主要内容:

  1. View、Text、Image:构建页面的三大核心组件。注意图片Image的mode属性。
  2. Button与表单组件:与用户交互的核心。Button的open-type能调起强大原生功能。表单组件用v-model实现数据双向绑定。
  3. Navigator与Scroll-View:组织页面和内容。Navigator负责路由跳转,要理解五种open-type的区别。Scroll-View提供滚动区域,要注意它的高度和性能问题。
  4. 自定义组件:必会内容。理解了Props下行、Events上行、Slots分发的数据流,你就掌握了组件通信的精髓。easycom规则让组件使用更便捷。

如果你觉得这篇文章对你有所帮助,能够对uni-app的基础组件有更清晰的认识,不要吝啬你的“一键三连”(点赞、关注、收藏)哦(手动狗头)!你的支持是我持续创作的最大动力。 在学习过程中遇到任何问题,或者有哪里没看明白,都欢迎在评论区留言,我会尽力解答。


版权声明:本文为【《uni-app跨平台开发完全指南》】系列第五篇,原创文章,转载请注明出处。

基于 Vue3+TypeScript+Vant 的评论组件开发实践

作者 胖虎265
2025年11月7日 16:41

在现代 Web 应用中,评论功能是提升用户互动性的核心模块之一。它不仅需要满足用户发表评论、回复互动的基础需求,还需要兼顾易用性、视觉体验和功能完整性。本文将结合完整代码,详细分享基于 Vue3+TypeScript+Vant 组件库开发的评论系统实现方案,从组件设计、代码实现到状态管理,层层拆解核心细节。

联想截图_20251107164213.jpg

一、整体架构设计

整个评论系统采用「组件化 + 状态管理」的架构模式,拆分为三个核心模块,各司其职且协同工作:

模块文件 核心职责 技术核心
CommentInput.vue 评论 / 回复输入弹窗,支持文本 + 表情输入 Vue3 组合式 API、Vant Popup/Field
CommentList.vue 评论列表展示,包含点赞、回复、删除等交互 条件渲染、事件监听、组件通信
comments.ts(Pinia) 全局评论状态管理,处理数据增删改查 Pinia 状态管理、TypeScript 接口定义

这种拆分遵循「单一职责原则」,让每个模块专注于自身功能,既提升了代码可维护性,也便于后续扩展。

二、核心模块代码详解

(一)评论输入组件:CommentInput.vue

负责接收用户输入(文本 + 表情),是交互入口。核心需求:支持多行输入、表情选择、内容同步、发送逻辑。

1. 模板结构核心代码

<van-popup v-model:show="show" position="bottom">
  <div class="comment-input">
    <!-- 文本输入框 -->
    <van-field
      type="textarea"
      rows="2"
      autosize
      v-model="inputValue"
      :placeholder="placeholder"
    />
    <!-- 操作栏:表情按钮+发送按钮 -->
    <div class="comment-actions">
      <van-icon name="smile-o" @click="onEmoji" />
      <van-button
        class="send-btn"
        round
        type="primary"
        :disabled="!inputValue"
        @click="handleSend"
      >发送</van-button>
    </div>
    <!-- 表情面板:折叠/展开切换 -->
    <div class="emoji-mart-wrapper" :class="{ expanded: showAllEmojis }">
      <div class="simple-emoji-list">
        <span
          v-for="(emoji, idx) in emojis"
          :key="idx"
          class="simple-emoji"
          @click="addEmojiFromPicker(emoji)"
        >{{ emoji }}</span>
      </div>
    </div>
  </div>
</van-popup>
  • 关键设计

    • van-popup实现底部弹窗,position="bottom"确保滑入效果;
    • 文本框用autosize自动适配高度,避免输入多行时滚动混乱;
    • 表情面板通过expanded类控制高度过渡(48px→240px),配合overflow-y:auto支持滚动。

2. 逻辑核心代码

import { ref, watch, defineProps, defineEmits } from 'vue'

// 定义props和emit,实现父子组件通信
const props = defineProps({
  show: Boolean,
  modelValue: String,
  placeholder: { type: String, default: '友善发言,理性交流' }
})
const emit = defineEmits(['update:show', 'update:modelValue', 'send'])

// 响应式变量
const show = ref(props.show) // 弹窗显示状态
const inputValue = ref(props.modelValue || '') // 输入内容
const showAllEmojis = ref(false) // 表情面板展开状态

// 表情库(包含表情、动物、食物等多分类)
const emojis = ['😀', '😁', '😂', ...] // 完整列表见原代码

// 监听props变化,同步到组件内部状态
watch(() => props.show, v => show.value = v)
watch(show, v => emit('update:show', v)) // 双向绑定弹窗状态
watch(() => props.modelValue, val => inputValue.value = val)
watch(inputValue, val => emit('update:modelValue', val)) // 同步输入内容

// 表情面板展开/收起切换
function onEmoji() {
  showAllEmojis.value = !showAllEmojis.value
}

// 选择表情:拼接至输入框
function addEmojiFromPicker(emoji: string) {
  inputValue.value += emoji
  emit('update:modelValue', inputValue.value)
}

// 发送评论
function handleSend() {
  if (!inputValue.value) return
  emit('send', inputValue.value) // 向父组件传递输入内容
  inputValue.value = '' // 清空输入框
  emit('update:modelValue', '')
  showAllEmojis.value = false // 收起表情面板
  show.value = false // 关闭弹窗
}
  • 关键逻辑

    • watch实现 props 与组件内部状态的双向同步,确保父子组件数据一致;
    • 表情选择直接拼接字符串,无需处理光标位置,简化逻辑;
    • 发送按钮通过!inputValue控制禁用状态,避免空内容提交。

3. 样式优化(SCSS)

.emoji-mart-wrapper {
  background: #fff;
  height: 48px;
  max-height: 48px;
  overflow-y: hidden;
  transition: max-height 0.3s, height 0.3s; // 平滑过渡
  &.expanded {
    height: 240px;
    max-height: 240px;
    overflow-y: auto;
  }
}
.simple-emoji {
  font-size: 24px;
  cursor: pointer;
  transition: transform 0.1s;
  &:hover {
    transform: scale(1.2); //  hover放大,提升交互反馈
  }
}

(二)评论列表组件:CommentList.vue

核心展示与交互模块,负责评论列表渲染、回复、点赞、删除、长按操作等。

1. 模板结构核心代码

<div class="comment-list">
  <!-- 评论列表 -->
  <div v-for="(comment, idx) in showComments" :key="comment.id" class="comment-item">
    <!-- 评论者头像 -->
    <img class="avatar" :src="comment.avatar" />
    <div class="comment-main">
      <div class="nickname">{{ comment.nickname }}</div>
      <!-- 评论内容:支持@高亮,绑定点击/长按事件 -->
      <div
        class="content"
        @click="openReply(idx, undefined, comment.userId)"
        @touchstart="onTouchStart(idx, undefined, comment.content)"
        @contextmenu.prevent="onContextMenu(idx, undefined, comment.content, $event)"
        v-html="comment.content"
      ></div>
      <!-- 操作栏:时间、回复、点赞 -->
      <div class="meta">
        <span class="time">{{ comment.time }}</span>
        <span class="reply" @click="openReply(idx, undefined, comment.userId)">回复</span>
        <span class="like" @click="likeComment(idx)" :class="{ 'liked-active': comment.liked }">
          <van-icon name="good-job-o" />
          {{ comment.likes }}
        </span>
      </div>
      <!-- 回复列表:支持折叠/展开 -->
      <div v-if="comment.replies && comment.replies.length" class="reply-list">
        <div
          v-for="(reply, ridx) in showAllReplies[idx] ? comment.replies : comment.replies.slice(0, 1)"
          :key="reply.id"
          class="comment-item reply-item"
        >
          <!-- 回复内容结构与评论一致,略 -->
        </div>
        <!-- 折叠/展开按钮 -->
        <div v-if="comment.replies.length > 1" class="expand-reply" @click="toggleReplies(idx)">
          {{ showAllReplies[idx] ? '收起' : `展开${comment.replies.length}条回复` }}
        </div>
      </div>
    </div>
  </div>

  <!-- 输入回复弹窗(复用CommentInput组件) -->
  <CommentInput
    v-model="replyContent"
    v-model:show="showReplyInput"
    :placeholder="replyTarget ? `回复 @${getNicknameByUserId(replyTarget.userId)}:` : '请输入回复内容~'"
    @send="sendReply"
  />

  <!-- 长按/右键操作菜单 -->
  <van-action-sheet
    v-model:show="showActionSheet"
    :actions="actionOptions"
    @select="onActionSelect"
    cancel-text="取消"
  />
</div>
  • 关键设计

    • 评论与回复共用一套结构,通过reply-item类区分样式,减少冗余;
    • 回复列表默认显示 1 条,超过 1 条显示「展开」按钮,优化视觉体验;
    • 复用CommentInput组件实现回复输入,提升代码复用率;
    • v-html渲染内容,支持回复中的 @用户高亮(蓝色文本)。

2. 核心逻辑代码

import { ref, watch, computed, PropType } from 'vue'
import CommentInput from '@/components/CommentInput.vue'
import { useCommentsStore, Comment, Reply } from '@/store/comments'
import { useUserStore } from '@/store/user'
import { showToast } from 'vant'

// Props定义:接收评论列表和是否显示全部
const props = defineProps({
  comments: { type: Array as PropType<Comment[]>, required: true },
  showAll: { type: Boolean, default: false }
})
const emit = defineEmits(['more'])

const commentsStore = useCommentsStore() // 评论状态管理
const userStore = useUserStore() // 用户状态(获取当前登录用户)

// 回复相关状态
const showReplyInput = ref(false) // 回复弹窗显示状态
const replyContent = ref('') // 回复内容
const replyTarget = ref<{ commentIdx: number; replyIdx?: number; userId: string } | null>(null) // 回复目标

// 控制回复列表折叠/展开
const showAllReplies = ref(props.comments.map(() => false))
watch(() => props.comments, val => {
  showAllReplies.value = val.map(() => false) // 评论列表变化时重置折叠状态
}, { immediate: true })

// 评论列表分页:默认显示2条,showAll为true时显示全部
const showComments = computed(() => {
  return props.showAll ? props.comments : props.comments.slice(0, 2)
})

// 当前登录用户ID(用于权限控制)
const currentUserId = computed(() => userStore.userInfo?.id?.toString() || 'anonymous')

// 1. 点赞评论
function likeComment(idx: number) {
  const comment = showComments.value[idx]
  commentsStore.likeComment(comment.id) // 调用Pinia Action修改状态
}

// 2. 回复评论/回复
function openReply(commentIdx: number, replyIdx?: number, userId?: string) {
  replyTarget.value = { commentIdx, replyIdx, userId: userId || '' }
  showReplyInput.value = true
  replyContent.value = '' // 清空输入框
}

// 3. 发送回复
function sendReply(val: string) {
  if (!val || !replyTarget.value) return
  const { commentIdx, replyIdx } = replyTarget.value
  const comment = showComments.value[commentIdx]
  let content = val
  // 回复某条回复时,添加@提及
  if (replyIdx !== undefined && comment.replies[replyIdx]) {
    content = `<span style='color:#409EFF'>@${comment.replies[replyIdx].nickname}</span> ${val}`
  }
  // 调用Pinia Action添加回复
  const userInfo = userStore.userInfo
  const reply: Reply = {
    id: Date.now(), // 用时间戳作为唯一ID
    avatar: userInfo?.avatar || getAssetUrl(userInfo?.gender === 'female' ? 'avatar_woman.svg' : 'avatar_man.svg'),
    nickname: userInfo?.nickname || '匿名用户',
    userId: userInfo?.id?.toString() || 'anonymous',
    content,
    time: new Date().toLocaleString(),
    likes: 0
  }
  commentsStore.addReply(comment.id, reply)
  showReplyInput.value = false
}

// 4. 长按/右键操作(复制/删除)
const showActionSheet = ref(false)
const actionOptions = ref([{ name: '复制' }, { name: '删除' }])
const actionTarget = ref<{ commentIdx: number; replyIdx?: number; content: string } | null>(null)
let touchTimer: any = null

// 设置操作菜单(只有自己的内容才显示删除)
function setActionOptions(commentIdx: number, replyIdx?: number) {
  let canDelete = false
  if (replyIdx !== undefined) {
    const comment = showComments.value[commentIdx]
    canDelete = comment.replies[replyIdx].userId === currentUserId.value
  } else {
    const comment = showComments.value[commentIdx]
    canDelete = comment.userId === currentUserId.value
  }
  actionOptions.value = canDelete ? [{ name: '复制' }, { name: '删除' }] : [{ name: '复制' }]
}

// 移动端长按触发
function onTouchStart(commentIdx: number, replyIdx: number | undefined, content: string) {
  setActionOptions(commentIdx, replyIdx)
  touchTimer = setTimeout(() => {
    actionTarget.value = { commentIdx, replyIdx, content }
    showActionSheet.value = true
  }, 500)
}

// 长按取消
function onTouchEnd() {
  if (touchTimer) clearTimeout(touchTimer)
}

// PC端右键菜单
function onContextMenu(commentIdx: number, replyIdx: number | undefined, content: string, e: Event) {
  e.preventDefault()
  setActionOptions(commentIdx, replyIdx)
  actionTarget.value = { commentIdx, replyIdx, content }
  showActionSheet.value = true
}

// 操作菜单选择(复制/删除)
async function onActionSelect(action: { name: string }) {
  if (!actionTarget.value) return
  const { commentIdx, replyIdx, content } = actionTarget.value
  if (action.name === '复制') {
    // 提取纯文本(过滤HTML标签)
    const tempDiv = document.createElement('div')
    tempDiv.innerHTML = content
    await navigator.clipboard.writeText(tempDiv.innerText)
    showToast('已复制')
  } else if (action.name === '删除') {
    if (replyIdx !== undefined) {
      commentsStore.deleteReply(showComments.value[commentIdx].id, showComments.value[commentIdx].replies[replyIdx].id)
    } else {
      commentsStore.deleteComment(showComments.value[commentIdx].id)
    }
    showToast('已删除')
  }
  showActionSheet.value = false
}
  • 关键逻辑

    • 权限控制:通过currentUserId与评论 / 回复的userId比对,仅显示自己内容的删除按钮;
    • 回复 @提及:回复特定用户时,自动拼接<span>标签实现蓝色高亮;
    • 兼容移动端 / PC 端:通过touchstart/touchend处理长按,contextmenu处理右键菜单;
    • 分页与折叠:评论列表默认显示 2 条,回复列表默认显示 1 条,优化长列表渲染性能。

(三)状态管理:comments.ts(Pinia)

负责管理评论全局状态,提供统一的数据操作 API,避免组件间数据传递混乱。

1. 数据模型定义(TypeScript 接口)

// 回复数据模型
export interface Reply {
  id: number
  avatar: string
  nickname: string
  userId: string
  content: string
  time: string
  likes: number
  liked?: boolean // 是否点赞
}

// 评论数据模型
export interface Comment {
  id: number
  avatar: string
  nickname: string
  userId: string
  content: string
  time: string
  likes: number
  liked?: boolean
  replies: Reply[] // 关联的回复列表
}
  • 用 TypeScript 接口定义数据结构,确保类型安全,减少开发时的类型错误。

2. Pinia Store 核心代码

import { defineStore } from 'pinia'
import { getAssetUrl } from '@/utils/index'
import { Comment, Reply } from './types'

export const useCommentsStore = defineStore('comments', {
  state: () => ({
    // 初始测试数据
    comments: [
      {
        id: 1,
        avatar: getAssetUrl('avatar_woman.svg'),
        nickname: '徐济锐',
        userId: 'xujirui',
        content: '内容详细丰富,详细的介绍了电信业务稽核系统技术规范,条理清晰。',
        time: '2025-06-09 17:08:17',
        likes: 4,
        replies: [
          {
            id: 11,
            avatar: getAssetUrl('avatar_man.svg'),
            nickname: '张亮',
            userId: 'zhangliang',
            content: '文本编辑调理清晰,很不错!',
            time: '2025-06-09 17:08:17',
            likes: 4
          }
        ]
      },
      // 更多测试数据...
    ] as Comment[]
  }),
  actions: {
    // 添加评论(插入到列表头部)
    addComment(comment: Comment) {
      this.comments.unshift(comment)
    },
    // 给指定评论添加回复
    addReply(commentId: number, reply: Reply) {
      const comment = this.comments.find(c => c.id === commentId)
      if (comment) comment.replies.push(reply)
    },
    // 点赞/取消点赞评论
    likeComment(id: number) {
      const comment = this.comments.find(c => c.id === id)
      if (comment) {
        comment.liked = !comment.liked
        comment.likes += comment.liked ? 1 : -1
      }
    },
    // 点赞/取消点赞回复
    likeReply(commentId: number, replyId: number) {
      const comment = this.comments.find(c => c.id === commentId)
      if (comment) {
        const reply = comment.replies.find(r => r.id === replyId)
        if (reply) {
          reply.liked = !reply.liked
          reply.likes += reply.liked ? 1 : -1
        }
      }
    },
    // 删除评论
    deleteComment(id: number) {
      this.comments = this.comments.filter(c => c.id !== id)
    },
    // 删除回复
    deleteReply(commentId: number, replyId: number) {
      const comment = this.comments.find(c => c.id === commentId)
      if (comment) {
        comment.replies = comment.replies.filter(r => r.id !== replyId)
      }
    }
  }
})
  • 关键设计

    • 所有数据操作都通过 Action 方法实现,组件无需直接修改 State,确保数据流向清晰;
    • 点赞逻辑通过liked状态切换,同步更新likes计数,避免重复点赞;
    • 初始测试数据模拟真实场景,便于开发调试。

三、核心技术亮点

  1. TypeScript 类型安全:从组件 Props 到 Pinia 状态,全程使用 TypeScript 接口约束,减少类型错误,提升开发体验;
  2. 组件复用CommentInput组件同时支持评论和回复输入,避免重复开发;
  3. 交互体验优化:表情面板平滑过渡、点赞状态切换反馈、长按防误触(500ms 延迟)、空状态提示;
  4. 性能优化:评论 / 回复列表分页渲染、折叠显示,减少 DOM 节点数量;;
  5. 权限控制:仅当前登录用户可删除自己的评论 / 回复,提升数据安全性。

浏览器&Websocket&热更新

2025年11月6日 17:01

热更新基本流程图

image.png

一、先明确:什么是热更新(HMR)?

热更新是指:在开发过程中,当代码发生修改并保存后,浏览器无需刷新整个页面,仅更新修改的模块(如组件、样式、逻辑等),同时保留页面当前状态(如表单输入、滚动位置、组件数据等)

与传统的 “自动刷新”(如 live-reload)相比,HMR 的核心优势是:

  • 局部更新:只替换修改的部分,不影响其他模块;
  • 状态保留:避免因全页刷新导致的状态丢失;
  • 速度极快:Vite 的 HMR 几乎是 “即时” 的(毫秒级)。

二、前端开发中:浏览器与开发服务器的 “连接基础”

要实现热更新,首先需要建立开发服务器浏览器之间的 “实时通信通道”,否则浏览器无法知道 “代码何时被修改了”。

在 Vite 中:

  1. 开发服务器(Vite Dev Server) :启动项目时(vite dev),Vite 会在本地启动一个 HTTP 服务器(默认端口 5173),负责提供页面资源(HTML、JS、CSS 等),同时监听文件变化。
  2. 浏览器:通过 HTTP 协议访问开发服务器,加载并渲染页面。
  3. 通信桥梁:仅靠 HTTP 协议无法实现 “服务器主动通知浏览器”(HTTP 是 “请求 - 响应” 模式,服务器不能主动发消息),因此需要 WebSocket 建立 “双向通信通道”。

三、WebSocket:浏览器与服务器的 “实时对讲机”

WebSocket 是一种全双工通信协议,允许客户端(浏览器)和服务器在建立连接后,双向实时发送消息(无需客户端反复请求)。这是热更新的 “通信核心”。

在 Vite 中,WebSocket 的作用是:

  • 服务器监听文件变化,当文件被修改时,通过 WebSocket 向浏览器 “发送更新通知”;
  • 浏览器收到通知后,通过 WebSocket 向服务器 “请求更新的模块内容”;
  • 双方通过 WebSocket 交换 “更新信息”(如哪个模块变了、新模块的地址等)。

四、Vite 热更新的完整流程(一步一步拆解)

假设我们在开发一个 Vue 项目,修改了 src/components/Hello.vue 并保存,Vite 的热更新流程如下:

步骤 1:Vite 开发服务器监听文件变化

  • Vite 启动时,会通过 chokidar 库(文件监听工具)对项目目录(如 src/)进行监听,实时检测文件的创建、修改、删除等操作。
  • 当我们修改并保存 Hello.vue 时,文件系统会触发 “修改事件”,Vite 服务器立刻感知到:src/components/Hello.vue 发生了变化。

步骤 2:Vite 服务器编译 “变更模块”(而非全量编译)

  • Vite 基于 “原生 ESM(ES 模块)” 工作:开发时不会打包所有文件,而是让浏览器直接通过 <script type="module"> 加载模块。

  • 当 Hello.vue 被修改后,Vite 只会重新编译这个单文件组件(.vue 文件):

    • 解析模板(template)生成渲染函数;
    • 处理脚本(script)和样式(style);
    • 生成该组件的 “更新后模块内容”,并标记其唯一标识(如 id=123)。
  • 同时,Vite 会分析 “依赖关系”:判断哪些模块依赖了 Hello.vue(比如父组件、页面等),确定需要更新的 “模块范围”。

步骤 3:服务器通过 WebSocket 向浏览器发送 “更新通知”

  • Vite 服务器内置了 WebSocket 服务(默认路径为 ws://localhost:5173/ws),浏览器加载页面时,会自动通过 JavaScript 连接这个 WebSocket。

  • 服务器将 “变更信息” 通过 WebSocket 发送给浏览器,信息格式类似:

    {
      "type": "update", // 类型:更新
      "updates": [
        {
          "type": "js-update", // 更新类型:JS 模块
          "path": "/src/components/Hello.vue", // 变更文件路径
          "acceptedPath": "/src/components/Hello.vue",
          "timestamp": 1699999999999 // 时间戳(避免缓存)
        }
      ]
    }
    

    这个消息告诉浏览器:Hello.vue 模块更新了,需要处理。

步骤 4:浏览器接收通知,请求 “更新的模块内容”

  • 浏览器的 Vite 客户端(Vite 注入的 HMR 运行时脚本)接收到 WebSocket 消息后,解析出需要更新的模块路径(Hello.vue)。

  • 客户端通过 HTTP 请求(而非 WebSocket)向服务器获取 “更新后的模块内容”,请求地址类似:

    http://localhost:5173/src/components/Hello.vue?t=1699999999999
    

    t 参数是时间戳,用于避免浏览器缓存旧内容)。

步骤 5:浏览器 “替换旧模块” 并 “局部更新视图”

  • 客户端拿到新的 Hello.vue 模块内容后,会执行 “模块替换”:

    • 对于 Vue 组件,Vite 会利用 Vue 的 defineComponent 和热更新 API(import.meta.hot),将旧组件的实例替换为新组件的实例;
    • 保留组件的状态(如 data 中的数据),仅更新模板、样式或逻辑;
    • 对于样式文件(如 .css),会直接替换 <style> 标签内容,无需重新渲染组件。
  • 替换完成后,Vue 的虚拟 DOM 会对比新旧节点,只更新页面中受影响的部分(如 Hello.vue 对应的 DOM 区域),实现 “局部刷新”。

步骤 6:处理 “无法热更新” 的情况(降级为刷新)

  • 某些场景下(如修改了入口文件 main.js、路由配置、全局状态等),模块依赖关系过于复杂,无法安全地局部更新。
  • 此时 Vite 会通过 WebSocket 发送 “全页刷新” 指令,浏览器收到后执行 location.reload(),确保代码更新生效。

五、关键技术点:Vite 如何实现 “极速 HMR”?

  1. 原生 ESM 按需加载:开发时不打包,浏览器直接加载模块,修改后只需重新编译单个模块,而非整个包(对比 Webpack 的 “打包后更新” 快得多)。
  2. 精确的依赖分析:Vite 会跟踪模块间的依赖关系(通过 import 语句),修改一个模块时,只通知依赖它的模块更新,范围最小化。
  3. 轻量的客户端运行时:Vite 向浏览器注入的 HMR 脚本非常精简,仅负责接收通知、请求新模块、替换旧模块,逻辑高效。
  4. 与框架深度集成:针对 Vue、React 等框架,Vite 提供了专门的 HMR 处理逻辑(如 Vue 的 @vitejs/plugin-vue 插件),确保组件状态正确保留。

总结:Vite 热更新的核心链路

文件修改(保存)
  ↓
Vite 服务器监听文件变化
  ↓
编译变更模块(仅修改的文件)
  ↓
WebSocket 发送更新通知(告诉浏览器“哪个模块变了”)
  ↓
浏览器通过 HTTP 请求新模块内容
  ↓
替换旧模块,框架(如 Vue)局部更新视图
  ↓
页面更新完成(状态保留,无需全量刷新)

场景假设:你修改了 src/App.vue 并保存

1. Vite 脚手架确实内置了 WebSocket 服务

  • 当你运行 vite dev 时,Vite 会同时启动两个服务:

    • HTTP 服务:默认 http://localhost:5173,负责给浏览器提供页面、JS、CSS 等资源(比如你在浏览器输入这个地址就能看到项目)。
    • WebSocket 服务:默认 ws://localhost:5173/ws,专门用来和浏览器 “实时聊天”(双向通信)。
  • 浏览器打开项目页面时,会自动通过一段 Vite 注入的 JS 代码,连接这个 WebSocket(相当于浏览器和服务器之间架了一根 “实时电话线”)。

2. 当文件变化时,Vite 先 “发现变化”,再通过 WebSocket 喊一声 “有东西改了!”

  • 你修改 App.vue 并按 Ctrl+S 保存:

    • Vite 会通过文件监听工具(类似 “监控摄像头”)立刻发现 App.vue 变了。
    • 它会快速处理这个文件(比如编译 Vue 模板、处理样式),生成 “更新后的内容”,并记下来 “是 App.vue 这个文件变了”。
  • 然后,Vite 通过 WebSocket 给浏览器发一条消息(就像打电话通知):

    {
      "type": "update",
      "updates": [{"path": "/src/App.vue", "timestamp": 123456}]
    }
    

    翻译成人话:“喂,浏览器!src/App.vue 这个文件刚刚改了,赶紧处理一下!”

3. 浏览器收到通知后,用 HTTP 请求 “主动要新内容”

  • 浏览器接收到 WebSocket 的消息后,知道了 “App.vue 变了”,但此时它还没有新内容。

  • 于是浏览器会通过 HTTP 协议,向 Vite 的 HTTP 服务发一个请求,要新的 App.vue 内容:

    GET http://localhost:5173/src/App.vue?t=123456
    

    t=123456 是时间戳,确保拿到的是最新的,不是缓存的旧内容)。

  • Vite 的 HTTP 服务收到请求后,把刚才处理好的 “更新后的 App.vue 内容” 返回给浏览器。

4. 浏览器拿到新内容,局部更新页面

  • 浏览器收到新的 App.vue 代码后,会:

    • 丢掉旧的 App.vue 模块(但保留组件状态,比如输入框里的文字)。
    • 用新代码替换,并重新渲染 App.vue 对应的页面部分(不会刷新整个页面)。
  • 最终你看到的效果:页面上只有 App.vue 相关的部分变了,其他内容和状态都没变。

一句话总结核心流程

你改了文件 → Vite 发现 → 用 WebSocket 通知浏览器“哪个文件变了” → 浏览器用 HTTP 要这个文件的新内容 → 浏览器局部更新页面

WebSocket 只负责 “传递变化的消息”(谁变了),真正的新内容还是通过 HTTP 请求获取 —— 分工明确,效率更高。这也是 Vite 热更新快的原因之一:只传必要的消息,拿必要的新内容,不做多余的事。

为啥websocket不一步到位传变化内容给浏览器

这个问题很关键!核心原因是: “直接传变化内容” 看似省一步,实际会引发更复杂的问题,反而降低效率。Vite 选择 “WebSocket 传通知 + HTTP 取内容” 的分工,是权衡了前端开发的复杂性后的最优解。

1. 首先,“变化的内容” 可能非常大,不适合用 WebSocket 直接传

  • 前端开发中,一个文件的修改可能涉及大量内容(比如一个复杂的 Vue 组件、包含数百行 CSS 的样式文件)。

  • WebSocket 虽然支持二进制传输,但设计初衷是 “轻量实时通信”(比如消息通知、状态同步),并不擅长高效传输大体积的代码内容。

  • 如果直接通过 WebSocket 传完整的更新内容,会:

    • 增加 WebSocket 连接的负担,可能导致消息堵塞(比如同时修改多个大文件时);
    • 浪费带宽(HTTP 对静态资源传输有更成熟的优化,如压缩、缓存控制)。

2. 其次,“变化的内容” 可能需要 “按需处理”,浏览器需要主动决策

  • 一个文件的修改可能影响多个模块(比如 A 依赖 B,B 依赖 C,改了 C 后 A、B 都可能需要更新)。
  • 浏览器需要先知道 “哪些模块变了”,再根据自己当前的模块依赖关系,决定 “要不要请求这个模块的新内容”(比如某些模块可能已经被卸载,不需要更新)。
  • 如果服务器直接把所有相关内容都推过来,浏览器可能收到很多无用信息(比如已经不需要的模块内容),反而增加处理成本。

3. 更重要的是:HTTP 对 “代码模块” 的传输有天然优势

  • 缓存控制:浏览器请求新模块时,通过 ?t=时间戳 可以轻松避免缓存(确保拿到最新内容),而 WebSocket 消息没有内置的缓存机制,需要手动处理。
  • 断点续传与重试:HTTP 对大文件传输有成熟的断点续传和失败重试机制,WebSocket 若传输中断,通常需要重新建立连接并重传全部内容。
  • 与浏览器模块系统兼容:现代浏览器原生支持通过 <script type="module"> 加载 ES 模块(Vite 开发时的核心机制),而模块加载天然依赖 HTTP 请求。直接用 WebSocket 传代码,还需要手动模拟模块加载逻辑,反而更复杂。

4. 举个生活例子:像外卖点餐

  • WebSocket 就像 “短信通知”:店家(服务器)告诉你 “你点的餐好了”(哪个文件变了),短信内容很短,效率高。

  • HTTP 请求就像 “去取餐”:你收到通知后,自己去店里(服务器)拿餐(新内容),按需行动。

  • 如果店家直接 “把餐扔到你家”(WebSocket 传内容),可能会出现:

    • 你不在家(浏览器没准备好处理),餐浪费了;
    • 点了 3 个菜,店家一次性全扔过来(大文件),可能洒了(传输失败)。

总结

Vite 之所以让 WebSocket 只传 “通知”、让 HTTP 负责 “传内容”,是因为:

  • 两者分工明确:WebSocket 擅长轻量实时通信,HTTP 擅长高效传输资源;
  • 适应前端开发的复杂性:模块依赖多变,按需请求比盲目推送更高效;
  • 利用浏览器原生能力:HTTP 与 ES 模块加载机制无缝兼容,减少额外逻辑。

这种设计看似多了一次 HTTP 请求,实则通过 “各司其职” 让整个热更新流程更稳定、更高效 —— 这也是 Vite 热更新速度远超传统工具的原因之一。

Vue 中的 JSX:让组件渲染更灵活的正确方式

作者 前端大付
2025年11月6日 16:01

在日常 Vue 项目中,你可能已经非常熟悉 template 写法:结构清晰、语义明确、直观易读。但当业务进入更复杂的阶段,你会发现:

  • 模板语法存在一定限制
  • 某些 UI 渲染逻辑十分动态
  • 条件/循环/组件嵌套变得越来越难写
  • h 函数(createVNode)看得懂,但自己写非常痛苦

这时,你可能会想:有没有一种方式既能保持 DOM 结构的直观性,又能充分利用 JavaScript 的灵活表达?

答案是:JSX

你可能会问:JSX 不是 React 的东西吗?
是,但 Vue 同样支持 JSX,并且在组件库、动态 UI 控件、高度抽象组件中大量使用。

本文将从三个核心问题带你理解 Vue 中的 JSX:

  1. JSX 的本质是什么?
  2. 为什么需要 JSX,它能解决什么问题?
  3. 在 Vue 中如何优雅地使用 JSX?

h 函数:理解 JSX 的前置知识

Vue 组件的 template 最终会被编译为一个 render 函数,render 函数会返回 虚拟 DOM(VNode)

也就是说,下面这段模板:

<h3>你好</h3>

最终会变成类似这样的 JavaScript:

h('h3', null, '你好')

也就是说:

h 函数 = 手写虚拟 DOM 的入口
JSX = h 函数的语法糖


为什么需要 JSX?来看一个真实例子

假设我们做一个动态标题组件 <Heading />,它根据 level 动态渲染 <h1> ~ <h6>

如果使用 template,你可能写成这样:

<h1 v-if="level === 1"><slot /></h1>
<h2 v-else-if="level === 2"><slot /></h2>
...
<h6 v-else-if="level === 6"><slot /></h6>

非常冗余、难拓展、维护成本高。

使用 h 函数可以简化为:

import { h, defineComponent } from 'vue'

export default defineComponent({
  props: { level: Number },
  setup(props, { slots }) {
    return () => h('h' + props.level, {}, slots.default())
  }
})

但写 h 函数并不优雅,标签、属性、事件都要自己构造。

这时 JSX 就来了。


在 Vue 中使用 JSX

① 安装 JSX 插件(Vite 项目)

npm install @vitejs/plugin-vue-jsx -D

② 在 vite.config.js 中启用

import vue from '@vitejs/plugin-vue'
import vueJsx from '@vitejs/plugin-vue-jsx'

export default {
  plugins: [vue(), vueJsx()]
}

③ 使用 JSX 改写 Heading 组件

import { defineComponent } from 'vue'

export default defineComponent({
  props: { level: Number },
  setup(props, { slots }) {
    const Tag = 'h' + props.level
    return () => <Tag>{slots.default()}</Tag>
  }
})

是不是比手写 h 爽太多了?
结构依然直观,但不受 template 语法局限。


JSX 的核心能力:灵活、动态、纯 JavaScript

举个再明显的例子:Todo 列表

import { defineComponent, ref } from 'vue'

export default defineComponent({
  setup() {
    const title = ref('')
    const todos = ref([])

    const addTodo = () => {
      if (title.value.trim()) {
        todos.value.push({ title: title.value })
        title.value = ''
      }
    }

    return () => (
      <div>
        <input vModel={title.value} />
        <button onClick={addTodo}>添加</button>
        <ul>
          {todos.value.length
            ? todos.value.map(t => <li>{t.title}</li>)
            : <li>暂无数据</li>}
        </ul>
      </div>
    )
  }
})

可以看到:

模板语法 JSX 对应写法
v-model vModel={value}
@click onClick={fn}
v-for array.map()
v-if 三元 / if 表达式

本质是 JavaScript,可以随意写逻辑。


JSX vs Template:应该如何选择?

对比点 template JSX
可读性 强,结构清晰 视业务复杂度而定
动态表达能力 较弱(语法受限) 非常强(JS 语法全支持)
编译优化 优秀,可静态提升 不如 template 友好
适用场景 普通业务 UI 高动态逻辑、组件库、渲染函数场景

一句话总结选择策略:

业务组件优先 template
高动态组件或组件库优先 JSX


JSX 并不是来替代 template 的,而是:

当 template 无法优雅表达渲染逻辑时,JSX 给你打开了一扇窗。

  • 它让组件变得更灵活
  • 它让写 render 函数变得不再痛苦
  • 它让 Vue 在复杂组件抽象层面更加强大

掌握 JSX,是从“会写 Vue”向“会设计 Vue 组件”的关键一步。

Vue 权限控制神技!自定义 auth 指令优雅实现按钮级权限管理

作者 apollo_qwe
2025年11月6日 15:01

Vue 权限控制神技!自定义 auth 指令优雅实现按钮级权限管理

在中后台系统开发中,按钮级别的权限控制是常见需求 —— 不同角色用户看到的操作按钮可能不同,直接写 if-else 判断又会导致代码冗余混乱。今天分享一个 Vue 自定义指令v-auth,一行代码就能搞定按钮的显示、隐藏或禁用,大幅提升代码整洁度!

一、指令核心功能

这个v-auth指令基于 Vuex 存储的用户权限数据,实现两大核心能力:

  1. 超级管理员自动放行,无需额外判断

  2. 普通用户支持两种权限控制模式:

    • 隐藏模式:无权限时直接移除 DOM 元素
    • 禁用模式:无权限时保留元素但添加禁用状态和样式

二、完整代码实现

// 权限控制指令:v-auth
Vue.directive('auth', {
  async inserted(el, binding) {
    const { value, modifiers } = binding;
    
    // 确保权限数据已加载,未加载则异步获取
    if (!store.getters.permissions) {
      //获取权限数据
    }
    
    const permissions = store.getters.permissions || []; // 兜底处理,避免报错

    // 超级管理员特权:拥有所有权限直接放行
    if (permissions.includes('*:*:*')) return;

    // 权限校验核心逻辑
    const isDisabled = modifiers.disabled; // 是否启用禁用模式
    const hasPermission = permissions.includes(value); // 校验用户是否拥有目标权限
    
    if (!hasPermission) {
      if (isDisabled) {
        // 禁用模式:添加禁用属性和自定义样式
        el.disabled = true;
        el.classList.add('disabled-button');
      } else {
        // 隐藏模式:从DOM中移除元素
        el.parentNode?.removeChild(el);
      }
    }
  }
});

三、代码逻辑逐行解析

1. 指令触发时机

使用inserted钩子,在元素插入 DOM 后执行校验,确保操作目标元素存在。

2. 权限数据加载

  • 先检查 Vuex 中是否已缓存权限数据
  • 未加载则调用user/getInfo异步接口获取,等待加载完成再继续校验

3. 权限判断逻辑

  • 超级管理员通过*:*:*标识直接放行,适配系统最高权限场景
  • 普通用户通过binding.value获取需要校验的权限标识(如"user:add"
  • 通过binding.modifiers.disabled切换控制模式,灵活适配不同 UI 需求

四、实际使用场景

1. 隐藏模式(默认)

无权限时直接隐藏按钮,适用于非核心操作按钮:

<el-button v-auth="'user:add'">新增用户</el-button>

2. 禁用模式

无权限时保留按钮但禁用,适用于需要提示用户权限不足的场景:

<el-button v-auth.disabled="'user:edit'">编辑用户</el-button>

六、总结

按钮权限控制的工作流程图:

flowchart TD
    A(("① 用户登录")) --> B[系统初始化]
    B --> C[渲染带v-auth的组件]
    C --> D{指令解析}
    
    D --> |解析到v-auth节点| E["② inserted钩子触发"]
    E --> F{权限数据已加载?}
    F -- 否 --> G["③ 调用store.dispatch()"]
    G --> H[获取用户权限数据]
    H --> F
    F -- 是 --> I{是超级管理员?}
    I -- 是 --> J["✅ 放行渲染"]
    I -- 否 --> K["④ 权限校验"]
    
    K --> L{检查修饰符}
    L -- disabled --> M["⑤ 禁用模式处理"]
    L -- 无修饰符 --> N["⑤ 隐藏模式处理"]
    
    M --> O{权限匹配?}
    O -- 匹配 --> P["✅ 保持可用状态"]
    O -- 不匹配 --> Q["🛑 添加disabled属性"]
    
    N --> R{权限匹配?}
    R -- 匹配 --> S["✅ 正常显示"]
    R -- 不匹配 --> T["🛑 移除DOM节点"]
    
    Q --> U[结束]
    T --> U
    P --> U
    S --> U
    
    style A fill:#4CAF50,color:white
    style G fill:#2196F3,color:white
    style Q fill:#FF5722,color:white
    style T fill:#FF5722,color:white
    style J fill:#4CAF50,color:white

这个v-auth指令将权限控制逻辑封装复用,摆脱了模板中大量的权限判断代码,让权限管理更优雅、维护成本更低。适用于各类中后台系统的按钮、菜单等元素权限控制,搭配 Vuex 的状态管理可实现全系统权限统一管控。

《uni-app跨平台开发完全指南》- 04 - 页面布局与样式基础

2025年11月6日 11:20

uni-app:掌握页面布局与样式

新手刚接触uni-app布局可能会遇到以下困惑:明明在模拟器上完美显示的页面,到了真机上就面目全非;iOS上对齐的元素,到Android上就错位几个像素,相信很多开发者都经历过。今天就带大家摸清了uni-app布局样式的门道,把这些经验毫无保留地分享给大家,让你少走弯路。

一、Flex布局

1.1 为什么Flex布局是移动端首选?

传统布局的痛点:

/* 传统方式实现垂直居中 */
.container {
  position: relative;
  height: 400px;
}
.center {
  position: absolute;
  top: 50%;
  left: 50%;
  width: 200px;
  height: 100px;
  margin-top: -50px;  /* 需要计算 */
  margin-left: -100px; /* 需要计算 */
}

Flex布局:

/* Flex布局实现垂直居中 */
.container {
  display: flex;
  justify-content: center;
  align-items: center;
  height: 400px;
}
.center {
  width: 200px;
  height: 100px;
}

从对比中不难看出,Flex布局用更少的代码、更清晰的逻辑解决了复杂的布局问题。

1.2 Flex布局的核心概念

为了更好地理解Flex布局,我们先来看一下它的基本模型:

Flex容器 (display: flex)
├─────────────────────────────────┤
│ 主轴方向 (flex-direction) →     │
│                                 │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐
│ │ 元素1   │ │ 元素2   │ │ 元素3   │ ← Flex元素
│ └─────────┘ └─────────┘ └─────────┘
│                                 │
│ ↑                               │
│ 交叉轴方向                       │
└─────────────────────────────────┘

Flex布局的两大核心:

  • 容器:设置display: flex的元素,控制内部项目的布局
  • 元素:容器的直接子元素,受容器属性控制

1.3 容器属性

1.3.1 flex-direction:布局方向

这个属性决定了元素的排列方向,是Flex布局的基础:

.container {
  /* 水平方向,从左到右(默认) */
  flex-direction: row;
  
  /* 水平方向,从右到左 */
  flex-direction: row-reverse;
  
  /* 垂直方向,从上到下 */
  flex-direction: column;
  
  /* 垂直方向,从下到上 */
  flex-direction: column-reverse;
}

实际应用场景分析:

属性值 适用场景
row 水平导航、卡片列表
column 表单布局、设置页面
row-reverse 阿拉伯语等从右向左语言
column-reverse 聊天界面(最新消息在底部)
1.3.2 justify-content:主轴对齐

这个属性控制元素在主轴上的对齐方式,使用频率非常高:

.container {
  display: flex;
  
  /* 起始位置对齐 */
  justify-content: flex-start;
  
  /* 末尾位置对齐 */
  justify-content: flex-end;
  
  /* 居中对齐 */
  justify-content: center;
  
  /* 两端对齐,项目间隔相等 */
  justify-content: space-between;
  
  /* 每个项目两侧间隔相等 */
  justify-content: space-around;
  
  /* 均匀分布,包括两端 */
  justify-content: space-evenly;
}

空间分布对比关系:

  • start - 从头开始
  • end - 从尾开始
  • center - 居中对齐
  • between - 元素"之间"有间隔
  • around - 每个元素"周围"有空间
  • evenly - 所有空间"均匀"分布
1.3.3 align-items:交叉轴对齐

控制元素在交叉轴上的对齐方式:

.container {
  display: flex;
  height: 300rpx; /* 需要明确高度 */
  
  /* 交叉轴起点对齐 */
  align-items: flex-start;
  
  /* 交叉轴终点对齐 */
  align-items: flex-end;
  
  /* 交叉轴中点对齐 */
  align-items: center;
  
  /* 基线对齐(文本相关) */
  align-items: baseline;
  
  /* 拉伸填充(默认) */
  align-items: stretch;
}

温馨提示align-items的效果与flex-direction密切相关:

  • flex-direction: row时,交叉轴是垂直方向
  • flex-direction: column时,交叉轴是水平方向

1.4 元素属性

1.4.1 flex-grow

控制元素放大比例,默认0(不放大):

.item {
  flex-grow: <number>; /* 默认0 */
}

计算原理:

总剩余空间 = 容器宽度 - 所有元素宽度总和
每个元素分配空间 = (元素的flex-grow / 所有元素flex-grow总和) × 总剩余空间

示例分析:

.container {
  width: 750rpx;
  display: flex;
}
.item1 { width: 100rpx; flex-grow: 1; }
.item2 { width: 100rpx; flex-grow: 2; }
.item3 { width: 100rpx; flex-grow: 1; }

/* 计算过程:
剩余空间 = 750 - (100+100+100) = 450rpx
flex-grow总和 = 1+2+1 = 4
item1分配 = (1/4)×450 = 112.5rpx → 最终宽度212.5rpx
item2分配 = (2/4)×450 = 225rpx → 最终宽度325rpx  
item3分配 = (1/4)×450 = 112.5rpx → 最终宽度212.5rpx
*/
1.4.2 flex-shrink

控制元素缩小比例,默认1(空间不足时缩小):

.item {
  flex-shrink: <number>; /* 默认1 */
}

小技巧:设置flex-shrink: 0可以防止元素被压缩,常用于固定宽度的元素。

1.4.3 flex-basis

定义元素在分配多余空间之前的初始大小:

.item {
  flex-basis: auto | <length>; /* 默认auto */
}
1.4.4 flex

flexflex-growflex-shrinkflex-basis的简写:

.item {
  /* 等价于 flex: 0 1 auto */
  flex: none;
  
  /* 等价于 flex: 1 1 0% */ 
  flex: 1;
  
  /* 等价于 flex: 1 1 auto */
  flex: auto;
  
  /* 自定义 */
  flex: 2 1 200rpx;
}

1.5 完整页面布局实现

让我们用Flex布局实现一个典型的移动端页面:

<view class="page-container">
  <!-- 顶部导航 -->
  <view class="header">
    <view class="nav-back"></view>
    <view class="nav-title">商品详情</view>
    <view class="nav-actions">···</view>
  </view>
  
  <!-- 内容区域 -->
  <view class="content">
    <!-- 商品图 -->
    <view class="product-image">
      <image src="/static/product.jpg" mode="aspectFit"></image>
    </view>
    
    <!-- 商品信息 -->
    <view class="product-info">
      <view class="product-name">高端智能手机 8GB+256GB</view>
      <view class="product-price">
        <text class="current-price">¥3999</text>
        <text class="original-price">¥4999</text>
      </view>
      <view class="product-tags">
        <text class="tag">限时优惠</text>
        <text class="tag">分期免息</text>
        <text class="tag">赠品</text>
      </view>
    </view>
    
    <!-- 规格选择 -->
    <view class="spec-section">
      <view class="section-title">选择规格</view>
      <view class="spec-options">
        <view class="spec-option active">8GB+256GB</view>
        <view class="spec-option">12GB+512GB</view>
      </view>
    </view>
  </view>
  
  <!-- 底部操作栏 -->
  <view class="footer">
    <view class="footer-actions">
      <view class="action-btn cart">购物车</view>
      <view class="action-btn buy-now">立即购买</view>
    </view>
  </view>
</view>
.page-container {
  display: flex;
  flex-direction: column;
  height: 100vh;
  background-color: #f5f5f5;
}

/* 头部导航 */
.header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  height: 88rpx;
  padding: 0 32rpx;
  background: white;
  border-bottom: 1rpx solid #eee;
}

.nav-back, .nav-actions {
  width: 60rpx;
  text-align: center;
  font-size: 36rpx;
}

.nav-title {
  flex: 1;
  text-align: center;
  font-size: 36rpx;
  font-weight: bold;
}

/* 内容区域 */
.content {
  flex: 1;
  overflow-y: auto;
}

.product-image {
  height: 750rpx;
  background: white;
}

.product-image image {
  width: 100%;
  height: 100%;
}

.product-info {
  padding: 32rpx;
  background: white;
  margin-bottom: 20rpx;
}

.product-name {
  font-size: 36rpx;
  font-weight: bold;
  margin-bottom: 20rpx;
  line-height: 1.4;
}

.product-price {
  display: flex;
  align-items: center;
  margin-bottom: 20rpx;
}

.current-price {
  font-size: 48rpx;
  color: #ff5000;
  font-weight: bold;
  margin-right: 20rpx;
}

.original-price {
  font-size: 28rpx;
  color: #999;
  text-decoration: line-through;
}

.product-tags {
  display: flex;
  flex-wrap: wrap;
  gap: 20rpx;
}

.tag {
  padding: 8rpx 20rpx;
  background: #fff2f2;
  color: #ff5000;
  font-size: 24rpx;
  border-radius: 8rpx;
}

/* 规格选择 */
.spec-section {
  background: white;
  padding: 32rpx;
}

.section-title {
  font-size: 32rpx;
  font-weight: bold;
  margin-bottom: 24rpx;
}

.spec-options {
  display: flex;
  gap: 20rpx;
}

.spec-option {
  padding: 20rpx 40rpx;
  border: 2rpx solid #e0e0e0;
  border-radius: 12rpx;
  font-size: 28rpx;
}

.spec-option.active {
  border-color: #007AFF;
  background: #f0f8ff;
  color: #007AFF;
}

/* 底部操作栏 */
.footer {
  background: white;
  border-top: 1rpx solid #eee;
  padding: 20rpx 32rpx;
}

.footer-actions {
  display: flex;
  gap: 20rpx;
}

.action-btn {
  flex: 1;
  height: 80rpx;
  border-radius: 40rpx;
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: 32rpx;
  font-weight: bold;
}

.cart {
  background: #fff2f2;
  color: #ff5000;
  border: 2rpx solid #ff5000;
}

.buy-now {
  background: #ff5000;
  color: white;
}

这个例子展示了如何用Flex布局构建复杂的页面结构,包含了水平布局、垂直布局、空间分配等各种技巧。

二、跨端适配:rpx单位系统

2.1 像素密度

要理解rpx的价值,首先要明白移动端面临的问题:

设备现状:

设备A: 4.7英寸, 750×1334像素, 326ppi
设备B: 6.1英寸, 828×1792像素, 326ppi  
设备C: 6.7英寸, 1284×2778像素, 458ppi

同样的CSS像素在不同设备上的物理尺寸不同,这就是我们需要响应式单位的原因。

2.2 rpx的工作原理

rpx的核心思想很简单:以屏幕宽度为基准的相对单位

rpx计算原理:
1rpx = (屏幕宽度 / 750) 物理像素

不同设备上的表现:

设备宽度 1rpx对应的物理像素 计算过程
750px 1px 750/750 = 1
375px 0.5px 375/750 = 0.5
1125px 1.5px 1125/750 = 1.5

2.3 rpx与其他单位的对比分析

为了更好地理解rpx,我们把它和其他常用单位做个对比:

/* 不同单位的对比示例 */
.element {
  width: 750rpx;    /* 总是占满屏幕宽度 */
  width: 100%;      /* 占满父容器宽度 */
  width: 375px;     /* 固定像素值 */
  width: 50vw;      /* 视窗宽度的50% */
}

2.4 rpx实际应用与问题排查

2.4.1 设计稿转换

情况一:750px设计稿(推荐)

设计稿测量值 = 直接写rpx值
设计稿200px → width: 200rpx

情况二:375px设计稿

rpx值 = (设计稿测量值 ÷ 375) × 750
设计稿200px → (200÷375)×750 = 400rpx

情况三:任意尺寸设计稿

// 通用转换公式
function pxToRpx(px, designWidth = 750) {
  return (px / designWidth) * 750;
}

// 使用示例
const buttonWidth = pxToRpx(200, 375); // 返回400
2.4.2 rpx常见问题

问题1:边框模糊

/* 不推荐 - 可能在不同设备上模糊 */
.element {
  border: 1rpx solid #e0e0e0;
}

/* 推荐 - 使用px保证清晰度 */
.element {
  border: 1px solid #e0e0e0;
}

问题2:大屏设备显示过大

.container {
  width: 750rpx; /* 在小屏上合适,大屏上可能太大 */
}

/* 解决方案:媒体查询限制最大宽度 */
@media (min-width: 768px) {
  .container {
    width: 100%;
    max-width: 500px;
    margin: 0 auto;
  }
}

2.5 响应式网格布局案例

<view class="product-grid">
  <view class="product-card" v-for="item in 8" :key="item">
    <image class="product-img" src="/static/product.jpg"></image>
    <view class="product-info">
      <text class="product-name">商品标题{{item}}</text>
      <text class="product-desc">商品描述信息</text>
      <view class="product-bottom">
        <text class="product-price">¥199</text>
        <text class="product-sales">销量: 1.2万</text>
      </view>
    </view>
  </view>
</view>
.product-grid {
  display: flex;
  flex-wrap: wrap;
  padding: 20rpx;
  gap: 20rpx; /* 间隙,需要确认平台支持 */
}

.product-card {
  width: calc((100% - 20rpx) / 2); /* 2列布局 */
  background: white;
  border-radius: 16rpx;
  overflow: hidden;
  box-shadow: 0 4rpx 20rpx rgba(0,0,0,0.08);
}

/* 兼容不支持gap的方案 */
.product-grid {
  display: flex;
  flex-wrap: wrap;
  padding: 20rpx;
  justify-content: space-between;
}

.product-card {
  width: 345rpx; /* (750-20*2-20)/2 = 345 */
  margin-bottom: 20rpx;
}

.product-img {
  width: 100%;
  height: 345rpx;
  display: block;
}

.product-info {
  padding: 20rpx;
}

.product-name {
  display: block;
  font-size: 28rpx;
  font-weight: bold;
  margin-bottom: 10rpx;
  line-height: 1.4;
}

.product-desc {
  display: block;
  font-size: 24rpx;
  color: #999;
  margin-bottom: 20rpx;
  line-height: 1.4;
}

.product-bottom {
  display: flex;
  justify-content: space-between;
  align-items: center;
}

.product-price {
  font-size: 32rpx;
  color: #ff5000;
  font-weight: bold;
}

.product-sales {
  font-size: 22rpx;
  color: #999;
}

/* 平板适配 */
@media (min-width: 768px) {
  .product-card {
    width: calc((100% - 40rpx) / 3); /* 3列布局 */
  }
}

/* 大屏适配 */
@media (min-width: 1024px) {
  .product-grid {
    max-width: 1200px;
    margin: 0 auto;
  }
  
  .product-card {
    width: calc((100% - 60rpx) / 4); /* 4列布局 */
  }
}

这个网格布局会在不同设备上自动调整列数,真正实现"一次编写,到处运行"。

三、样式作用域

3.1 全局样式

全局样式是整个应用的样式基石,应该在App.vue中统一定义:

/* App.vue - 全局样式体系 */
<style>
/* CSS变量定义 */
:root {
  /* 颜色 */
  --color-primary: #007AFF;
  --color-success: #4CD964;
  --color-warning: #FF9500;
  --color-error: #FF3B30;
  --color-text-primary: #333333;
  --color-text-secondary: #666666;
  --color-text-tertiary: #999999;
  
  /* 间距 */
  --spacing-xs: 10rpx;
  --spacing-sm: 20rpx;
  --spacing-md: 30rpx;
  --spacing-lg: 40rpx;
  --spacing-xl: 60rpx;
  
  /* 圆角 */
  --border-radius-sm: 8rpx;
  --border-radius-md: 12rpx;
  --border-radius-lg: 16rpx;
  --border-radius-xl: 24rpx;
  
  /* 字体 */
  --font-size-xs: 20rpx;
  --font-size-sm: 24rpx;
  --font-size-md: 28rpx;
  --font-size-lg: 32rpx;
  --font-size-xl: 36rpx;
  
  /* 阴影 */
  --shadow-sm: 0 2rpx 8rpx rgba(0,0,0,0.1);
  --shadow-md: 0 4rpx 20rpx rgba(0,0,0,0.12);
  --shadow-lg: 0 8rpx 40rpx rgba(0,0,0,0.15);
}

/* 全局重置样式 */
page {
  font-family: -apple-system, BlinkMacSystemFont, 'Helvetica Neue', Helvetica, 
               'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', 
               SimSun, sans-serif;
  background-color: #F8F8F8;
  color: var(--color-text-primary);
  font-size: var(--font-size-md);
  line-height: 1.6;
}

/* 工具类 - 原子CSS */
.text-center { text-align: center; }
.text-left { text-align: left; }
.text-right { text-align: right; }

.flex { display: flex; }
.flex-column { flex-direction: column; }
.flex-center { 
  display: flex;
  align-items: center;
  justify-content: center;
}
.flex-between {
  display: flex;
  align-items: center;
  justify-content: space-between;
}

.m-10 { margin: 10rpx; }
.m-20 { margin: 20rpx; }
.p-10 { padding: 10rpx; }
.p-20 { padding: 20rpx; }

/* 通用组件样式 */
.uni-button {
  padding: 24rpx 48rpx;
  border-radius: var(--border-radius-md);
  font-size: var(--font-size-lg);
  border: none;
  background-color: var(--color-primary);
  color: white;
  transition: all 0.3s ease;
}

.uni-button:active {
  opacity: 0.8;
  transform: scale(0.98);
}
</style>

3.2 局部样式

局部样式通过scoped属性实现样式隔离,避免样式污染:

scoped样式原理:

<!-- 编译前 -->
<template>
  <view class="container">
    <text class="title">标题</text>
  </view>
</template>

<style scoped>
.container {
  padding: 32rpx;
}
.title {
  color: #007AFF;
  font-size: 36rpx;
}
</style>

<!-- 编译后 -->
<template>
  <view class="container" data-v-f3f3eg9>
    <text class="title" data-v-f3f3eg9>标题</text>
  </view>
</template>

<style>
.container[data-v-f3f3eg9] {
  padding: 32rpx;
}
.title[data-v-f3f3eg9] {
  color: #007AFF;
  font-size: 36rpx;
}
</style>

3.3 样式穿透

当需要修改子组件样式时,使用深度选择器:

/* 修改uni-ui组件样式 */
.custom-card ::v-deep .uni-card {
  border-radius: 24rpx;
  box-shadow: var(--shadow-lg);
}

.custom-card ::v-deep .uni-card__header {
  padding: 32rpx 32rpx 0;
  border-bottom: none;
}

/* 兼容不同平台的写法 */
.custom-card /deep/ .uni-card__content {
  padding: 32rpx;
}

3.4 条件编译

uni-app的条件编译可以针对不同平台编写特定样式:

/* 通用基础样式 */
.button {
  padding: 24rpx 48rpx;
  border-radius: 12rpx;
  font-size: 32rpx;
}

/* 微信小程序特有样式 */
/* #ifdef MP-WEIXIN */
.button {
  border-radius: 8rpx;
}
/* #endif */

/* H5平台特有样式 */
/* #ifdef H5 */
.button {
  cursor: pointer;
  transition: all 0.3s ease;
}
.button:hover {
  opacity: 0.9;
  transform: translateY(-2rpx);
}
/* #endif */

/* App平台特有样式 */
/* #ifdef APP-PLUS */
.button {
  border-radius: 16rpx;
}
/* #endif */

3.5 样式架构

推荐的项目样式结构:

styles/
├── variables.css     # CSS变量定义
├── reset.css         # 重置样式
├── mixins.css        # 混合宏
├── components/       # 组件样式
│   ├── button.css
│   ├── card.css
│   └── form.css
├── pages/           # 页面样式
│   ├── home.css
│   ├── profile.css
│   └── ...
└── utils.css        # 工具类

在App.vue中导入:

<style>
/* 导入样式文件 */
@import './styles/variables.css';
@import './styles/reset.css';
@import './styles/utils.css';
@import './styles/components/button.css';
</style>

四、CSS3高级特性

4.1 渐变与阴影

4.1.1 渐变
/* 线性渐变 */
.gradient-bg {
  /* 基础渐变 */
  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
  
  /* 多色渐变 */
  background: linear-gradient(90deg, 
    #FF6B6B 0%, 
    #4ECDC4 33%, 
    #45B7D1 66%, 
    #96CEB4 100%);
  
  /* 透明渐变 - 遮罩效果 */
  background: linear-gradient(
    to bottom,
    rgba(0,0,0,0.8) 0%,
    rgba(0,0,0,0) 100%
  );
}

/* 文字渐变效果 */
.gradient-text {
  background: linear-gradient(135deg, #667eea, #764ba2);
  -webkit-background-clip: text;
  -webkit-text-fill-color: transparent;
  background-clip: text;
}
4.1.2 阴影
/* 基础阴影层级 */
.shadow-layer-1 {
  box-shadow: 0 2rpx 8rpx rgba(0, 0, 0, 0.1);
}

.shadow-layer-2 {
  box-shadow: 0 4rpx 20rpx rgba(0, 0, 0, 0.12);
}

.shadow-layer-3 {
  box-shadow: 0 8rpx 40rpx rgba(0, 0, 0, 0.15);
}

/* 内阴影 */
.shadow-inner {
  box-shadow: inset 0 2rpx 4rpx rgba(0, 0, 0, 0.06);
}

/* 多重阴影 */
.shadow-multi {
  box-shadow: 
    0 2rpx 4rpx rgba(0, 0, 0, 0.1),
    0 8rpx 16rpx rgba(0, 0, 0, 0.1);
}

/* 悬浮效果 */
.card {
  transition: all 0.3s ease;
  box-shadow: var(--shadow-md);
}

.card:hover {
  box-shadow: var(--shadow-lg);
  transform: translateY(-4rpx);
}

4.2 变换与动画

4.2.1 变换
/* 2D变换 */
.transform-2d {
  /* 平移 */
  transform: translate(100rpx, 50rpx);
  
  /* 缩放 */
  transform: scale(1.1);
  
  /* 旋转 */
  transform: rotate(45deg);
  
  /* 倾斜 */
  transform: skew(15deg, 5deg);
  
  /* 组合变换 */
  transform: translateX(50rpx) rotate(15deg) scale(1.05);
}

/* 3D变换 */
.card-3d {
  perspective: 1000rpx; /* 透视点 */
}

.card-inner {
  transition: transform 0.6s;
  transform-style: preserve-3d; /* 保持3D空间 */
}

.card-3d:hover .card-inner {
  transform: rotateY(180deg);
}

.card-front, .card-back {
  backface-visibility: hidden; /* 隐藏背面 */
}

.card-back {
  transform: rotateY(180deg);
}
4.2.2 动画
/* 关键帧动画 */
@keyframes slideIn {
  0% {
    opacity: 0;
    transform: translateY(60rpx) scale(0.9);
  }
  100% {
    opacity: 1;
    transform: translateY(0) scale(1);
  }
}

@keyframes bounce {
  0%, 100% {
    transform: translateY(0);
  }
  50% {
    transform: translateY(-20rpx);
  }
}

@keyframes pulse {
  0%, 100% {
    opacity: 1;
  }
  50% {
    opacity: 0.7;
  }
}

/* 动画类 */
.slide-in {
  animation: slideIn 0.6s ease-out;
}

.bounce {
  animation: bounce 0.6s ease-in-out;
}

.pulse {
  animation: pulse 2s infinite;
}

/* 交互动画 */
.interactive-btn {
  transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
}

.interactive-btn:active {
  transform: scale(0.95);
  opacity: 0.8;
}

4.3 高级交互动效

<template>
  <view class="interactive-demo">
    <!-- 悬浮操作按钮 -->
    <view class="fab" :class="{ active: menuOpen }" @click="toggleMenu">
      <text class="fab-icon">+</text>
    </view>
    
    <!-- 悬浮菜单 -->
    <view class="fab-menu" :class="{ active: menuOpen }">
      <view class="fab-item" @click="handleAction('share')" 
            :style="{ transitionDelay: '0.1s' }">
        <text class="fab-icon">📤</text>
        <text class="fab-text">分享</text>
      </view>
      <view class="fab-item" @click="handleAction('favorite')"
            :style="{ transitionDelay: '0.2s' }">
        <text class="fab-icon">❤️</text>
        <text class="fab-text">收藏</text>
      </view>
      <view class="fab-item" @click="handleAction('download')"
            :style="{ transitionDelay: '0.3s' }">
        <text class="fab-icon">📥</text>
        <text class="fab-text">下载</text>
      </view>
    </view>
    
    <!-- 动画卡片网格 -->
    <view class="animated-grid">
      <view class="grid-item" v-for="(item, index) in gridItems" 
            :key="index"
            :style="{
              animationDelay: `${index * 0.1}s`,
              background: item.color
            }"
            @click="animateItem(index)">
        <text class="item-text">{{ item.text }}</text>
      </view>
    </view>
  </view>
</template>

<script>
export default {
  data() {
    return {
      menuOpen: false,
      gridItems: [
        { text: '卡片1', color: 'linear-gradient(135deg, #667eea, #764ba2)' },
        { text: '卡片2', color: 'linear-gradient(135deg, #f093fb, #f5576c)' },
        { text: '卡片3', color: 'linear-gradient(135deg, #4facfe, #00f2fe)' },
        { text: '卡片4', color: 'linear-gradient(135deg, #43e97b, #38f9d7)' },
        { text: '卡片5', color: 'linear-gradient(135deg, #fa709a, #fee140)' },
        { text: '卡片6', color: 'linear-gradient(135deg, #a8edea, #fed6e3)' }
      ]
    }
  },
  methods: {
    toggleMenu() {
      this.menuOpen = !this.menuOpen
    },
    handleAction(action) {
      uni.showToast({
        title: `执行: ${action}`,
        icon: 'none'
      })
      this.menuOpen = false
    },
    animateItem(index) {
      // 可以添加更复杂的动画逻辑
      console.log('点击卡片:', index)
    }
  }
}
</script>

<style scoped>
.interactive-demo {
  padding: 40rpx;
  min-height: 100vh;
  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
}

/* 悬浮操作按钮 */
.fab {
  position: fixed;
  bottom: 80rpx;
  right: 40rpx;
  width: 120rpx;
  height: 120rpx;
  background: #FF3B30;
  border-radius: 50%;
  display: flex;
  align-items: center;
  justify-content: center;
  box-shadow: 0 8rpx 32rpx rgba(255, 59, 48, 0.4);
  transition: all 0.4s cubic-bezier(0.68, -0.55, 0.265, 1.55);
  z-index: 1000;
  cursor: pointer;
}

.fab-icon {
  font-size: 48rpx;
  color: white;
  transition: transform 0.4s ease;
}

.fab.active {
  transform: rotate(135deg);
  background: #007AFF;
}

/* 悬浮菜单 */
.fab-menu {
  position: fixed;
  bottom: 220rpx;
  right: 70rpx;
  opacity: 0;
  visibility: hidden;
  transform: translateY(40rpx) scale(0.8);
  transition: all 0.4s cubic-bezier(0.68, -0.55, 0.265, 1.55);
}

.fab-menu.active {
  opacity: 1;
  visibility: visible;
  transform: translateY(0) scale(1);
}

.fab-item {
  display: flex;
  align-items: center;
  background: rgba(255, 255, 255, 0.95);
  backdrop-filter: blur(20rpx);
  padding: 24rpx 32rpx;
  margin-bottom: 20rpx;
  border-radius: 50rpx;
  box-shadow: 0 8rpx 32rpx rgba(0, 0, 0, 0.15);
  transform: translateX(60rpx);
  opacity: 0;
  transition: all 0.4s ease;
}

.fab-menu.active .fab-item {
  transform: translateX(0);
  opacity: 1;
}

.fab-text {
  font-size: 28rpx;
  color: #333;
  margin-left: 16rpx;
  white-space: nowrap;
}

/* 动画网格 */
.animated-grid {
  display: grid;
  grid-template-columns: repeat(2, 1fr);
  gap: 30rpx;
  margin-top: 40rpx;
}

.grid-item {
  height: 200rpx;
  border-radius: 24rpx;
  display: flex;
  align-items: center;
  justify-content: center;
  box-shadow: 0 8rpx 32rpx rgba(0, 0, 0, 0.2);
  animation: cardEntrance 0.6s ease-out both;
  transition: all 0.3s ease;
  cursor: pointer;
}

.grid-item:active {
  transform: scale(0.95);
  box-shadow: 0 4rpx 16rpx rgba(0, 0, 0, 0.3);
}

.item-text {
  color: white;
  font-size: 32rpx;
  font-weight: bold;
  text-shadow: 0 2rpx 8rpx rgba(0, 0, 0, 0.3);
}

/* 入场动画 */
@keyframes cardEntrance {
  from {
    opacity: 0;
    transform: translateY(60rpx) scale(0.9) rotateX(45deg);
  }
  to {
    opacity: 1;
    transform: translateY(0) scale(1) rotateX(0);
  }
}

/* 响应式调整 */
@media (max-width: 750px) {
  .animated-grid {
    grid-template-columns: 1fr;
  }
}

@media (min-width: 751px) and (max-width: 1200px) {
  .animated-grid {
    grid-template-columns: repeat(3, 1fr);
  }
}

@media (min-width: 1201px) {
  .animated-grid {
    grid-template-columns: repeat(4, 1fr);
    max-width: 1200px;
    margin: 40rpx auto;
  }
}
</style>

五、性能优化

5.1 样式性能优化

5.1.1 选择器性能
/* 不推荐 - 性能差 */
.container .list .item .title .text {
  color: red;
}

/* 推荐 - 性能好 */
.item-text {
  color: red;
}

/* 不推荐 - 通用选择器性能差 */
* {
  margin: 0;
  padding: 0;
}

/* 推荐 - 明确指定元素 */
view, text, image {
  margin: 0;
  padding: 0;
}
5.1.2 动画性能优化
/* 不推荐 - 触发重排的属性 */
.animate-slow {
  animation: changeWidth 1s infinite;
}

@keyframes changeWidth {
  0% { width: 100rpx; }
  100% { width: 200rpx; }
}

/* 推荐 - 只触发重绘的属性 */
.animate-fast {
  animation: changeOpacity 1s infinite;
}

@keyframes changeOpacity {
  0% { opacity: 1; }
  100% { opacity: 0.5; }
}

/* 启用GPU加速 */
.gpu-accelerated {
  transform: translateZ(0);
  will-change: transform;
}

5.2 维护性

5.2.1 BEM命名规范
/* Block - 块 */
.product-card { }

/* Element - 元素 */  
.product-card__image { }
.product-card__title { }
.product-card__price { }

/* Modifier - 修饰符 */
.product-card--featured { }
.product-card__price--discount { }
5.2.2 样式组织架构
styles/
├── base/           # 基础样式
│   ├── variables.css
│   ├── reset.css
│   └── typography.css
├── components/     # 组件样式
│   ├── buttons.css
│   ├── forms.css
│   └── cards.css
├── layouts/        # 布局样式
│   ├── header.css
│   ├── footer.css
│   └── grid.css
├── utils/          # 工具类
│   ├── spacing.css
│   ├── display.css
│   └── text.css
└── themes/         # 主题样式
    ├── light.css
    └── dark.css

通过本节的学习,我们掌握了:Flex布局rpx单位样式设计css3高级特性,欢迎在评论区留言,我会及时解答。


版权声明:本文内容基于实战经验总结,欢迎分享交流,但请注明出处。禁止商业用途转载。

GPT-6 会带来科学革命?奥特曼最新设想:AI CEO、便宜医疗与全新计算机

2025年11月6日 11:00

访谈链接:🎧 YouTube:Tyler Cowen x Sam Altman 全程访谈

一、OpenAI 的第二次“进化宣言”

在经历资本重组、Ilya 离场、与微软“重新订婚”之后,Sam Altman 再次出现在公众视野。但这次,他没有讲产品,而是描绘了一个AI 改写科学、社会与人的世界图景

这期访谈由经济学家 Tyler Cowen 主持,发生在 10 月 17 日的 Progress Conference。访谈发布后,AI 圈几乎是震了一下——它不像新闻稿,更像一份来自未来的备忘录

奥特曼的核心论点可以用一句话概括:

“GPT-6 将带来科学革命,人类正走向‘两人加 AI’就能运营十亿美元公司的时代。”

二、科学革命的信号:GPT-6 不再只是“聪明”,而是能发现

在奥特曼看来,GPT-3 让我们第一次看到 AI 像有灵魂;GPT-5 让我们第一次看到 AI 有了创造。 而 GPT-6 的目标,是让“AI 成为科学研究的合作者”。

“GPT-5 已经出现了零星的科学灵感闪光,但 GPT-6 可能会真正推动科研突破。”

对科研机构的提醒是:

“别等到发布才开始准备。AI 不只是辅助工具,而是你下一位研究员。”

这句话的重量不亚于 90 年代互联网刚被提出时那种“你必须上网”的宣言。

三、AI CEO:组织的终极实验

奥特曼甚至公开提到,OpenAI 内部已经在思考 “由 AI 运营公司” 的实验。

“如果 OpenAI 不是第一个有 AI CEO 的公司,那我就失职了。”

他的逻辑很冷静:

两三年内,会出现由两三个人 + AI 一起运营的十亿美元级公司;

企业的部分部门(财务、研发、运营)将有 80% 工作由 AI 自动完成;

“CEO 这个角色的外向部分(媒体、政治)依然是人,但决策和执行层面会被 AI 接管。”

这意味着,AI 不仅取代岗位,还可能重塑组织结构的定义。在奥特曼的思路里,未来的“公司”,更像是一台以 AI 为核心的“智能自治体”。

四、AI 电商与经济重构:信任与利润率塌缩

访谈中一个被忽视但极具爆发潜力的细节,是 ChatGPT 正在测试电商功能。

“旅行和商品推荐功能会先上线,我们只收取标准交易费,不掺广告。”

奥特曼坦言:

“搜索引擎广告模式与用户利益相悖;而 ChatGPT 的商业逻辑,是基于信任。”

未来当 ChatGPT 告诉你哪家酒店最好时,你相信它——这信任本身,就是新的经济护城河。但他也认为:AI 会压低几乎所有行业的利润率,包括中介、预订、甚至 SaaS 模型。这是一个“低利润但高效率”的未来经济。

五、算力瓶颈:核聚变与电子的战争

当被问到“为什么不多造 GPU”时,奥特曼回答惊人:

“因为我们得先造出更多的电子。”

他认为算力的真正瓶颈是能源。短期靠天然气,长期靠核聚变 + 太阳能。OpenAI 正在下注未来几十年的能源革命,而不仅仅是模型参数。

这句话背后的现实是:AI 的未来属于能源公司 + 模型公司 + 芯片公司三位一体的结构。

六、AI 教育:本科回报率下降,但“使用 AI 的能力”会取代学历

奥特曼预测:

“普通本科的经济回报会持续下降。能有效使用 AI 的人,会在各行各业获得更高回报。”

这意味着未来教育体系可能分裂成两类:

实验型 AI 学校:用 AI 直接参与学习;

传统大学体系:被迫改革但进度缓慢。

他甚至预言:“AI 学习曲线极低,人类会像当年学 Google 一样自然掌握。”

换句话说,Prompt Engineering 只是开端,AI Literacy(AI 素养)才是未来的学历。

七、AI 与现实世界:住房、医疗、自由与心理健康

奥特曼在访谈中也谈到社会层面:

住房与医疗成本将下降——因为 AI 能极大降低制药和诊疗成本;

成人自由应被尊重——OpenAI 将恢复部分内容限制,让成年人“像成年人一样使用 AI”;

心理健康保护将被系统化——AI 将被视作“高敏感内容的心理交互体”,需特殊防护。

这是 OpenAI 第一次在“社会治理”层面谈伦理与自由的平衡。

八、终极目标:发明一台“为 AI 而生的计算机”

在访谈尾声,奥特曼抛出一句未来学级别的爆点:

“OpenAI 的目标,是发明一种全新的计算设备,一种为 AI 重新设计的人机界面。”

他认为,过去 50 年的计算范式都是围绕“人操控计算机”建立的,而未来将是:

“AI 操控世界,人类只需确认。”

这台新机器,或许正是他与 Jony Ive 合作的“AI 硬件”项目雏形——一台介于手机、伴侣与助理之间的“新形态计算设备”。

九、前端周看视角:

—— AI 不仅在生成世界,更在重写“系统架构”

从开发者视角看,GPT-6 的关键词其实是 System Rewrite。它不是更聪明的 LLM,而是一种操作系统级的范式转变

我们写代码,不再是写功能,而是在编排智能体;

我们做架构,不再是分层,而是设计任务协作图;

我们建应用,不再是页面,而是智能节点间的对话接口。

AI 将不只是“编程工具”,而是“系统的第二意识”。从这里看,奥特曼口中的“AI CEO”“AI 科学家”“AI 设备”,其实都是同一个母体的分身:人工智能体的社会化。

🪐 尾声:AI 革命不是未来时,而是进行时

奥特曼最后被问到的终极问题是: “当你能对超级智能输入一句提示时,你会输入什么?”

他没有回答。但这个空白本身,或许就是人类与 AI 的分界线:

—— AI 负责创造一切,而人类,仍在寻找意义。

前端人必看的 node_modules 瘦身秘籍:从臃肿到轻盈,Umi 项目依赖优化实战

作者 洞窝技术
2025年11月6日 10:01

目录

  • 一、量化分析:给你的依赖做 "CT 扫描"
  • 二、精简依赖清单
  • 三、Umi 专属优化:框架特性深度利用
  • 四、依赖管理升级:从 npm 到 pnpm
  • 五、删除非必要文件 —— 用autoclean斩断 “垃圾文件”
  • 六、长期维护 —— 避免 “二次臃肿”
  • 七、实战案例:1.5GB 到 900MB 的蜕变
  • 八、总结

在现代前端开发中,当你执行npm install后看到 node_modules 文件夹膨胀到 1.5GB 时,不必惊讶 —— 这已是常态。但对于 Umi 框架项目而言,这个 "体积怪兽" 不仅吞噬磁盘空间,更会导致开发启动缓慢、构建时长增加、部署包体积飙升等一系列问题。本文将基于 Umi 框架特性,提供一套可落地的完整优化方案,从分析到执行,一步步将 node_modules 体积控制在合理范围。

graph TD
    A[node_modules臃肿] -->| 安装analytics分析插件 | B(查看包体积分布情况)
    B --> C[解决方案]
    C --> | 安装depcheck |D[剔除无用的插件]
    C --> E[依赖替换计划]
    C --> F[umi内置优化]
    C --> G[依赖管理升级]
    C --> |autoclean|H[删除无用空文件]
    C --> I[持续维护]

一、量化分析:给你的依赖做 "CT 扫描"

在优化之前,我们需要精准定位问题 —— 哪些依赖在 "作恶"?Umi 项目可通过以下工具组合进行全面体检。

1.1 安装分析工具链

# 全局安装核心分析工具
npm install -g depcheck

1.2 全方位扫描依赖状况

1.2.1 检测冗余依赖

# 在项目根目录执行
depcheck

该命令会输出三类关键信息:

Unused dependencies
├── lodash  # 生产依赖中未使用
└── moment  # 生产依赖中未使用
Unused devDependencies
├── eslint-plugin-vue  # 开发依赖中未使用
└── webpack-cli        # 开发依赖中未使用
Missing dependencies
└── axios  # 代码中使用了,但未在package.json声明

1.2.2 depcheck介绍

depcheck并非简单 “字符串匹配”,而是通过AST 语法分析 + 依赖图谱构建实现精准检测,核心步骤分 3 步:

  1. 依赖图谱采集:解析package.json中的dependencies/devDependencies,生成 “已声明依赖列表”;同时遍历项目源码目录(默认排除node_modules/dist等目录),记录所有通过import/require引入的 “实际使用依赖列表”。
  2. AST 语法树分析:对.js/.ts/.jsx等源码文件构建抽象语法树(AST),提取ImportDeclaration(ES 模块)、CallExpression(CommonJS 模块)中的依赖标识符(如import lodash from 'lodash'中的lodash),排除 “仅声明未调用” 的依赖(如代码中import moment from 'moment'但未使用moment变量)。
  3. 双向比对与分类:- 未使用依赖(Unused dependencies):已声明但未在 AST 中找到调用的依赖;
    • 缺失依赖(Missing dependencies):AST 中找到调用但未在package.json声明的依赖;
    • 开发 / 生产依赖混淆:结合 “依赖使用场景” 判断(如eslint仅在开发阶段调用,若出现在dependencies中则提示分类错误)。

1.2.3 analyze 介绍

Umi 框架内置的体积分析配置(即 analyze 配置项)本质上是对 Webpack 生态中 webpack-bundle-analyzer 插件的封装,通过自动化配置简化了开发者手动集成该插件的流程,最终实现对项目打包体积的可视化分析。

  1. 原理解析

    1. 底层依赖:webpack-bundle-analyzer Umi 基于 Webpack 构建,而 webpack-bundle-analyzer 是 Webpack 生态中最常用的体积分析工具。它的工作原理是:

      1. 在 Webpack 构建结束后,解析打包产物(如 dist 目录下的 JS/CSS 文件)和对应的 sourcemap(用于映射打包代码与原始源码)。
      2. 分析每个 chunk(打包后的代码块)的体积、内部包含的模块(如第三方依赖、业务代码)及其体积占比。
      3. 通过可视化界面(交互式树状图、列表)展示分析结果,支持按体积排序、查看模块依赖关系等。
    2. Umi 内置配置的封装逻辑 Umi 的 analyze 配置并非重新实现体积分析功能,而是通过框架层自动处理了 webpack-bundle-analyzer 的集成细节,具体包括:

      1. 条件性引入插件 当开发者在 Umi 配置文件(config/config.ts.umirc.ts)中开启 analyze: { ... } 时,Umi 会在 Webpack 配置阶段自动引入 webpack-bundle-analyzer 插件,并将用户配置的参数(如 analyzerPortopenAnalyzer 等)传递给该插件。 例如,用户修改 Umi 配置文件(config/config.ts.umirc.ts):

        import { defineConfig } from 'umi';
        export default defineConfig({
        analyze: {
        analyzerMode: 'server', // 分析模式 server本地服务器 static 静态html文件 disabled禁用分析
        analyzerPort: 8888, // 端口
        openAnalyzer: true, // 是否自动在浏览器中打开
        generateStatsFile: false, // 是否生成统计文件
        statsFilename: 'stats.json', // 文件名称
        logLevel: 'info', // 日志等级
        defaultSizes: 'parsed', // stat  // gzip // 显示文件大小的计算方式
        },
        }
        

        Umi 会将其转化为 Webpack 插件配置:

        const BundleAnalyzerPlugin = require('webpack-bundle-analyzer').BundleAnalyzerPlugin;
        module.exports = {
        plugins: [
        new BundleAnalyzerPlugin({
        analyzerMode: 'server', // 启动本地服务展示报告
        analyzerPort: 8888,    // 服务端口
        openAnalyzer: true,    // 构建后自动打开浏览器
        }),
        ],
        };
        
  2. 与 Umi 构建流程联动Umi 的构建命令(umi build)会触发 Webpack 的打包过程。当 analyze 配置开启时,Webpack 在打包完成后会执行 webpack-bundle-analyzer 的逻辑:

  • 启动一个本地 HTTP 服务(默认端口 8888),将分析结果以 HTML 页面的形式展示。

  • 自动打开浏览器访问该服务,开发者可直观查看体积分析报告

  1. 默认参数的合理性优化Umi 对 analyze 配置提供了合理的默认值(如默认 analyzerMode: 'server'openAnalyzer: true),无需开发者手动配置即可快速使用,降低了使用门槛。

1.2.4 分析报告的生成逻辑

  1. 数据来源:Webpack 打包过程中会生成 stats 对象(包含构建过程的详细信息,如模块依赖、chunk 组成、体积等),webpack-bundle-analyzer 通过解析该对象获取基础数据。

  2. 体积计算:报告中展示的体积通常是未压缩的原始体积(便于分析模块真实占比),但也会标注 gzip 压缩后的体积(更接近生产环境实际传输大小)。

  3. 可视化呈现:通过树状图(每个节点代表一个模块或 chunk,大小与体积成正比)和列表(按体积排序)展示,支持点击节点查看子模块细节。

  4. stats对象拆解以及体积计算规则

    1. stats 对象的核心数据结构:Webpack 构建时会生成包含 “模块依赖树” 的stats对象,关键字段包括:- modules:所有参与构建的模块(含业务代码、第三方依赖),每个模块记录id(唯一标识)、size(原始体积)、dependencies(子依赖列表)、resource(文件路径);

    • chunks:打包后的代码块,每个 chunk 记录idmodules(包含的模块 ID 列表)、size(chunk 原始体积)、gzipSize(gzip 压缩后体积);

    • assets:最终输出的静态资源(如main.xx.js),关联对应的 chunk 及体积。

    1. 体积计算的两个维度:- 原始体积(parsed size):模块经过 Webpack 解析(如 babel 转译、loader 处理)后的未压缩体积,反映 “模块真实占用的内存空间”,用于定位 “大体积模块根源”;

    • 压缩体积(gzip size):通过 ZIP 压缩算法计算的体积,接近生产环境 CDN 传输的实际大小,用于评估 “用户加载速度影响”;
    • 注意:analyze报告中的 “重复依赖体积”,是通过比对不同 chunk 中modulesresource路径(如node_modules/lodash/lodash.js在两个 chunk 中均出现),累加重复模块的体积得出。
  5. Umi 内置的体积分析配置本质是对 webpack-bundle-analyzer 插件的 “零配置” 封装,通过框架层自动处理插件引入、参数传递和构建流程联动,让开发者无需关心 Webpack 底层细节,仅通过简单配置即可快速生成项目体积分析报告,从而定位大体积依赖、冗余代码等问题,为性能优化提供依据。

1.2.5 使用

# 启动分析(需要配置环境变量)
ANALYZE=1 umi dev

# 构建分析(需要配置环境变量)
ANALYZE=1 umi build
在分析页面中,你可以:
  • 查看每个依赖包的体积占比
  • 识别重复引入的依赖
  • 发现意外引入的大型依赖

二、精简依赖清单

经过分析后,首先要做的就是 "减肥"—— 移除不必要的依赖,这是最直接有效的优化手段。

2.1 移除未使用依赖

根据depcheck的输出结果,执行卸载命令:

# 卸载未使用的生产依赖
npm uninstall <package-name>

# 卸载未使用的开发依赖
npm uninstall --save-dev <package-name>

清理 “未声明但已安装” 的依赖(防止误删):
npm prune  # 仅保留package.json中声明的依赖

注意事项

  • 卸载前先在代码中搜索确认该依赖确实未被使用

  • 对于不确定的依赖,可先移至 devDependencies 观察一段时间

  • 团队协作项目需同步更新 package-lock.json 或 yarn.lock

    2.2 区分依赖类型

确保依赖类型划分正确,避免开发依赖混入生产依赖:

{
  "dependencies": {
    // 仅包含运行时必需的依赖
    "react": "^18.2.0",
    "react-dom": "^18.2.0",
    "dayjs": "^1.11.7"  // 运行时需要的日期处理库
  },
  "devDependencies": {
    // 开发和构建时需要的工具
    "@umijs/preset-react": "^2.9.0",
    "@types/react": "^18.0.26",
    "eslint": "^8.30.0",  // 仅开发时使用的代码检查工具
    "umi": "^3.5.40"
  }
}

2.3 依赖替换计划

2.3.1 拆解其体积膨胀的底层机制

  1. 全量打包与冗余代码:- moment:默认包含所有地区的语言包(如locale/zh-cn.jslocale/en-gb.js),即使项目仅用 “日期格式化” 功能,也会打包全部语言包(占总体积的 40% 以上);
    • lodash(全量包):包含 100 + 工具函数,项目若仅用debounce/throttle,仍会打包其余 90% 未使用函数,属于 “按需加载缺失” 导致的冗余。
  2. ES5 兼容代码冗余: 传统依赖(如axios@0.27.0前版本)为兼容 IE 浏览器,会内置Promise/Array.prototype.includes等 ES6+API 的 polyfill(如core-js代码),而现代前端项目(如基于 Umi 3+)已通过browserslist指定 “不兼容 IE”,这些 polyfill 成为无效冗余代码,占体积 15%-20%。
  3. 依赖嵌套层级深: 以axios为例,其依赖follow-redirects(处理重定向),而follow-redirects又依赖debug(日志工具),debug再依赖ms(时间格式化)—— 这种 “依赖链过长” 导致 “间接依赖体积累加”,且若其他依赖也依赖debug的不同版本,会引发 “版本分叉”(如debug@3.xdebug@4.x同时存在)。 针对 Umi 项目常用的大型依赖,推荐以下轻量替代方案:
功能场景 传统重量级依赖 推荐轻量替代 体积减少 替换难度
日期处理 moment(240kB) dayjs(7kB) 97%
工具库 lodash(248kB) lodash-es (按需加载) 90%+
HTTP 客户端 axios(142kB) ky(4.8kB) 95%
状态管理 redux+react-redux(36kB) zustand(1.5kB) 95%
表单处理 antd-form (含在 antd 中) react-hook-form(10kB) 视情况 中高
UI 组件库 antd (完整,~500kB) antd 按需加载 + lodash-es 60-80%

2.3.2 “轻量” 并非 “功能阉割”,而是 “技术设计优化”

  1. 模块化架构设计:- dayjs:采用 “核心 + 插件” 架构,核心体积仅 7kB(含基础日期处理),语言包、高级功能(如相对时间relativeTime)需手动导入(如import 'dayjs/locale/zh-cn'),避免 “全量打包”;
    • lodash-es:基于 ES 模块(ESM)设计,支持 “树摇(Tree Shaking)”—— Webpack/Rollup 会自动剔除未使用的函数(如import { debounce } from 'lodash-es',仅打包debounce相关代码),而传统lodash(CommonJS 模块)因 “函数挂载在全局对象”(如_ = require('lodash')),无法被 Tree Shaking 优化。
  2. 现代语法原生兼容ky(替代axios)仅支持 ES6 + 环境,直接使用原生fetch API(无需内置Promise polyfill),且移除axios中 “过时功能”(如transformRequest的兼容处理),体积从 142kB 降至 4.8kB,核心是 “放弃旧环境兼容,聚焦现代浏览器”。
  3. 依赖链扁平化zustand(替代redux+react-redux)无任何第三方依赖,核心逻辑仅 1.5kB,而redux依赖loose-envify(环境变量处理)、react-redux依赖hoist-non-react-statics(组件静态属性提升),间接依赖体积累加导致总大小达 36kB—— 轻量依赖的 “零依赖 / 少依赖” 设计,从根源减少 “依赖嵌套冗余”。

替换实操示例(moment → dayjs)

  1. 卸载旧依赖:

    npm uninstall moment
    
  2. 安装新依赖:

    npm install dayjs --save
    
  3. 代码替换(批量替换可使用 IDE 全局替换功能):

    // 旧代码
    import moment from 'moment';
    moment().format('YYYY-MM-DD');
    

// 新代码 import dayjs from 'dayjs'; dayjs().format('YYYY-MM-DD');

效果:中小型项目可减少 10%-30% 的体积,尤其适合历史项目的 “首次瘦身”。

## 三、Umi 专属优化:框架特性深度利用
Umi 框架内置了多项优化能力,充分利用这些特性可显著减少依赖体积。
### 3.1 路由级懒加载配置

Umi 的路由系统默认支持懒加载,只需正确配置路由即可实现按路由分割代码:
```js
export default [
  {
    path: '/',
    component: '../layouts/BasicLayout',
    routes: [
      { 
        path: '/', 
        name: '首页', 
        component: './Home' 
      },
      { 
        path: '/dashboard', 
        name: '数据看板', 
        component: './Dashboard',
        // 可配置更精细的分割策略
        // 仅在访问该路由时才加载echarts
        chunkGroup: 'dashboard'
      },
      { 
        path: '/analysis', 
        name: '深度分析', 
        component: './Analysis',
        // 大型页面单独分割
        chunkGroup: 'analysis'
      },
      { 
        path: '/setting', 
        name: '系统设置', 
        component: './Setting'
      }
    ]
  }
];

优化效果:访问首页时仅加载首页所需依赖,不会加载 dashboard 所需的 echarts 等重型库

3.2 组件级动态导入

对于页面内的大型组件(如富文本编辑器、图表组件),使用 Umi 的dynamic方法实现按需加载:

import { dynamic, useState } from 'umi';
import { Button } from 'antd';

// 动态导入ECharts组件(仅在需要时加载)
const EChartComponent = dynamic({
  loader: () => import('@/components/EChartComponent'),
  // 加载状态提示
  loading: () => <div className="loading">图表加载中...</div>,
  // 延迟加载,避免快速切换导致的不必要加载
  delay: 200,
});

// 动态导入数据导出组件(仅在点击按钮时加载)
const DataExportComponent = dynamic({
  loader: () => import('@/components/DataExportComponent'),
  loading: () => <div className="loading">准备导出工具...</div>,
});

export default function Dashboard() {
  const [showExport, setShowExport] = useState(false);

  return (
    <div className="dashboard">
      <h1>数据看板</h1>
      {/* 图表组件会在页面加载时开始加载 */}
      <EChartComponent />

      <Button onClick={() => setShowExport(true)}>
        导出数据
      </Button>

      {/* 导出组件仅在点击按钮后才会加载 */}
      {showExport && <DataExportComponent />}
    </div>
  );
}

3.3 配置外部依赖 (Externals)

import { defineConfig } from 'umi';

export default defineConfig({
  // 配置外部依赖
  externals: {
    // 键:包名,值:全局变量名
    react: 'window.React',
    'react-dom': 'window.ReactDOM',
    'react-router': 'window.ReactRouter',
    lodash: 'window._',
    echarts: 'window.echarts',
  },

  // 配置CDN链接(生产环境)
  scripts: [
    'https://cdn.jsdelivr.net/npm/react@18.2.0/umd/react.production.min.js',
    'https://cdn.jsdelivr.net/npm/react-dom@18.2.0/umd/react-dom.production.min.js',
    'https://cdn.jsdelivr.net/npm/react-router@6.8.1/umd/react-router.min.js',
    'https://cdn.jsdelivr.net/npm/lodash@4.17.21/lodash.min.js',
    'https://cdn.jsdelivr.net/npm/echarts@5.4.2/dist/echarts.min.js',
  ],

  // 开发环境仍使用本地依赖,避免CDN不稳定
  define: {
    'process.env.NODE_ENV': process.env.NODE_ENV,
  },

  // 条件性加载CDN
  headScripts: process.env.NODE_ENV === 'production' ? [
    // 生产环境额外的CDN脚本
  ] : [],
});

注意:配置 externals 后需确保代码中不再通过import引入这些库

3.4 优化 Ant Design 等 UI 组件库

Umi 配合@umijs/plugin-antd可实现 Ant Design 的按需加载

import { defineConfig } from 'umi';

export default defineConfig({
  antd: {
    // 启用按需加载
    import: true,
    // 配置主题,减少不必要的样式生成
    theme: {
      'primary-color': '#1890ff',
      'link-color': '#1890ff',
      'success-color': '#52c41a',
      // 只保留必要的主题变量,减少css体积
    },
  },

  // 配置babel-plugin-import优化其他组件库
  extraBabelPlugins: [
    [
      'import',
      {
        libraryName: 'lodash',
        libraryDirectory: '',
        camel2DashComponentName: false,
      },
      'lodash',
    ],
    [
      'import',
      {
        libraryName: '@ant-design/icons',
        libraryDirectory: 'es/icons',
        camel2DashComponentName: false,
      },
      'antd-icons',
    ],
  ],
});

四、依赖管理升级:从 npm 到 pnpm

npm/yarn 的 “嵌套依赖” 机制是根源之一。例如:

  • 项目依赖A@1.0.0,而A又依赖B@2.0.0;

  • 同时项目依赖C@3.0.0,C又依赖B@1.0.0;

  • 此时 node_modules 中会同时存在B@1.0.0和B@2.0.0,即使两者差异极小,也会重复占用空间。

对于复杂项目,这种 “版本分叉” 会呈指数级增长,最终导致大量重复代码堆积。

4.1 为什么pnpm会比npm要快

  • 少复制文件:npm 安装软件包时,就像在每个项目里都单独建了一个小仓库,把每个软件包都复制一份放进去。如果有 10 个项目都要用同一个软件包,那这个软件包就会被复制 10 次,很浪费时间。而 pnpm 呢,就像建了一个大的中央仓库,把所有软件包都放在里面,每个项目需要某个软件包时,不是再复制一份,而是通过一种类似 “快捷方式” 的硬链接去引用中央仓库里的软件包,这样就不用重复复制,安装速度自然就快了。
  • 安装速度快:pnpm 在安装软件包时,就像有多个工人同时工作,能一起去下载和安装不同的软件包,充分利用了电脑的性能。而 npm 通常是一个工人先完成一个软件包的安装,再去安装下一个,所以 pnpm 安装多个软件包时会更快。
  • 依赖关系清晰:npm 在解析软件包的依赖关系时,就像一个人在迷宫里慢慢找路,有时候可能会走一些冤枉路,重复去解析一些已经解析过的依赖关系。而 pnpm 则像有一张清晰的地图,能一下子就找到每个软件包需要的其他软件包,不会做多余的工作,所以解析速度更快。
  • 管理大型项目更高效:如果项目很大,或者有很多子项目(这种情况叫 Monorepo),npm 管理起来就会比较吃力,就像一个人要同时照顾很多孩子,可能会顾不过来。而 pnpm 对这种大型项目做了优化,能更好地管理各个子项目的依赖关系,让它们共享一些依赖的软件包,避免重复安装,所以处理起来更快。

Umi 项目迁移步骤如下(3分钟搞定):

4.2 安装 pnpm

# 安装pnpm
npm install -g pnpm

# 验证安装
pnpm --version

4.3 清理旧依赖

# 删除现有node_modules
rm -rf node_modules

# 删除锁文件
rm -f package-lock.json yarn.lock

4.4 用 pnpm 重新安装依赖

# 安装依赖(会生成pnpm-lock.yaml)
pnpm install

# 验证安装结果
pnpm ls

4.5 umi3.x + 低版本node(16) 升级pnpm指南

pnpm需要至少Node.js v18.12的版本才能正常运行。所以实际项目中有的node版本可能是18以下,这里来教大家怎么升级

4.5.1 启动

pnpm run start

4.5.2 报错

node:internal/crypto/hash:69
  this[kHandle] = new _Hash(algorithm, xofLen);
                  ^
Error: error:0308010C:digital envelope routines::unsupported

常发生在使用较新的 Node.js 版本(如 v18+)运行一些基于 Webpack 4 或更早版本构建的项目时,原因是 Node.js 升级后对 OpenSSL 加密算法的支持发生了变化,导致旧版构建工具不兼容。

4.5.2 解决方案

  1. 临时设置环境变量(最简单,推荐测试用) Windows(cmd 命令行)

    set NODE_OPTIONS=--openssl-legacy-provider && npm start
    

    Windows(PowerShell)

    $env:NODE_OPTIONS="--openssl-legacy-provider" && npm start
    

    Mac/Linux(终端)

    NODE_OPTIONS=--openssl-legacy-provider npm start
    
  2. 降低node版本

    nvm ls
    nvm install
    nvm use
    

    使用nvm直接降级即可

  3. 升级umi4.x

五、删除非必要文件 —— 用autoclean斩断 “垃圾文件”

核心目标:移除依赖中的测试、文档、日志等无用文件。 工具:yarn 自带的autoclean或 npm 生态的modclean。 以npm modclean(更轻量,无需额外安装):

  1. 安装modclean:

    npm install modclean -g
    
  2. 执行清理(默认清理常见无用文件,支持自定义规则):

    modclean -n default -o  # -n:规则集,-o:删除空文件夹
    

    注意不同的modclean版本配置不一样 modclean3.x版本可直接运行上面命令,2.x版本需要配置文件

步骤 1:创建配置文件(.modcleanrc)添加 empty: true 配置(作用等同于 -o 参数):

{
  "empty": true,  // 启用:清理后自动删除空文件夹
  "rules": {
    "default": {   // 复用默认规则集(等同于命令行 -n default)
      "include": [
        "**/__tests__/**",
        "**/test/**",
        "**/docs/**",
        "**/examples/**",
        "**/*.log",
        "**/*.md",
        "**/.gitignore"
      ]
    }
  },
  "defaultRule": "default"  // 默认使用上述规则集
}

步骤 2:执行清理命令

modclean -c .modcleanrc  # -c 指定配置文件路径

验证效果 查看 node_modules 中是否存在空文件夹(Mac/Linux)

find ./node_modules -type d -empty

Windows 系统(PowerShell):

Get-ChildItem -Path ./node_modules -Directory -Recurse | Where-Object { $_.GetFiles().Count -eq 0 -and $_.GetDirectories().Count -eq 0 }

理想结果:执行后无任何输出,说明所有空文件夹已被删除; 效果:单个依赖的体积可减少大概40% ,例如lodash清理后从 2MB 降至 1.2MB,axios从 1.5MB 降至 0.9MB。

六、长期维护 —— 避免 “二次臃肿”

优化后若不维护,node_modules 可能再次膨胀,需建立 3 个习惯:

  1. 锁定依赖版本:使用package-lock.json(npm)或yarn.lock(yarn),避免安装时自动升级到高版本(可能引入冗余依赖)。
  2. 定期更新依赖:用npm outdatedyarn outdated查看过时依赖,优先更新体积小、无破坏性变更的包(避免因依赖过旧导致兼容性问题,间接增加依赖体积)。
  3. 新增依赖前检查体积:在bundlephobia查询新依赖的体积,拒绝 “大而全” 但仅用少量功能的包(如仅用lodashdebounce,则直接引入lodash.debounce而非全量lodash)。

6.1 从 “人工操作” 升级到 “工程化监控”

bundlephobia 能快速查询依赖体积,核心是 “云端模拟 Webpack 构建 + 体积分析”,步骤如下:

  1. 依赖下载与构建: 当查询lodash时,bundlephobia 会从 npm 仓库下载lodash的最新版本,通过 “模拟 Webpack+Tree Shaking” 构建(默认配置mode: productionoptimization.usedExports: true),生成 “全量导入”(import _ from 'lodash')和 “按需导入”(import { debounce } from 'lodash')两种场景的构建产物。

  2. 体积计算与对比:- 原始体积:构建产物的未压缩大小(对应 Webpack 的parsed size);

    • 压缩体积:通过gzip(默认压缩级别 6)和brotli(更高效的压缩算法)计算的体积;
    • 依赖链体积:自动解析该依赖的所有子依赖体积,累加得出 “总依赖体积”(如axios的 142kB 包含follow-redirects等子依赖的体积)。
  3. 版本对比功能: 记录该依赖历史版本的体积变化(如moment@2.29.0moment@2.29.4的体积是否增加),并标注 “体积突变版本”(如某版本引入新子依赖导致体积暴涨)—— 帮助用户选择 “体积稳定的版本”。

    6.2 如何在 CI/CD 流程中集成体积监控”,避免 “依赖体积回退”

    核心工具为size-limit(基于 Webpack 的体积检测工具):

  4. size-limit 的工作原理:- 配置文件(.size-limit.json)中指定 “需要监控的入口文件”(如src/index.js)和 “体积阈值”(如100kB);

    • 运行size-limit时,工具会模拟生产环境构建(使用 Webpack/Rollup),计算入口文件对应的 chunk 体积;
    • 若体积超过阈值,直接报错(如 “体积 120kB 超过阈值 100kB”),阻断 CI 流程(如 GitHub Actions)。
  5. 与 Git 钩子的集成: 通过husky配置pre-commit钩子,每次提交代码前自动运行size-limit,若新增依赖导致体积超标,禁止提交 —— 原理是 “在代码提交阶段提前拦截问题,避免等到构建时才发现”。

  6. 体积变化报告生成: 集成size-limit --json输出体积变化数据,结合github-action-size等工具,在 PR(Pull Request)中自动生成 “体积对比报告”(如 “本次 PR 新增依赖导致体积增加 15kB”),让团队直观看到 “依赖变更的体积影响”。

七、实战案例:1.5GB 到 900MB 的蜕变

指标 初始状态 优化后状态 优化幅度
node_modules 体积 1.5GB 996MB 减少35.5%
依赖安装时间 1分钟 26.6秒 减少50.8%
项目构建时间 2分38秒 1分20秒 减少57.5%

八、总结

node_modules 体积膨胀是现代 JavaScript 开发中的普遍问题,但通过系统的分析和有针对性的优化,我们完全可以驯服这个 "体积怪兽"。从精简依赖清单到选择轻量替代品,从使用现代包管理器到构建优化,每一步都能带来显著的改善。 记住,控制 node_modules 体积是一个持续的过程,需要团队共同努力和长期坚持。通过建立良好的依赖管理习惯和自动化监控机制,我们可以保持项目的轻盈和高效,让开发体验更加流畅。 最后,每引入一个新依赖,都应该深思熟虑,因为每一行不需要的代码,都是未来的技术债务。

作者:洞窝-佳宇

基于Monaco的diffEditor实现内容对比

作者 AKclown
2025年11月5日 18:22

前言

最近收到一个需求,实现两个配置文件对比的能。一开始想着那简单直接用采用monacodiffEditor组件就可以了。在开发的时候发现没这么简单,因为monaco内置的diffEditor只有两种状态新增删除,但是我们产品需要我们存在三种状态新增删除更新

  • monaco默认的效果,行样式没有与我的样式保持一致,只存在两种状态 image.png

  • 我需要实现效果,行样式保持一致,并且存在三种状态 image.png

需求分析

  1. 需要计算出新增删除差异各占多少行,这里采用diffEidtor提供的getLineChanges方法获取所有行改动,然后分析数据
  2. 如何判断新增行删除行差异行呢?(这里主要想明白,你的状态是跟着视图走的,左侧空行代表新增,右侧空行代表删除、两侧都存在代表更新,是不是一说就明白呢? 但是我之前还结合charChanges算了好久,后面发现根本就不需要)
1. 因为originalStartLineNumber和originalEndLineNumber为1,而modifiedStartLineNumber和modifiedEndLineNumber是1-2。那么表示第一行为更新状态、第二行为新增状态
2. 由于originalStartLineNumber和originalEndLineNumber为3,但是modifiedEndLineNumber为0,那么表示更新后被移除了,则第三行为删除状态
[    {        "originalStartLineNumber": 1,        "originalEndLineNumber": 1,        "modifiedStartLineNumber": 1,        "modifiedEndLineNumber": 2,        "charChanges": [...]
    },
    {
        "originalStartLineNumber": 3,
        "originalEndLineNumber": 3,
        "modifiedStartLineNumber": 3,
        "modifiedEndLineNumber": 0
    }
]

3. 想明白新增行删除行差异行的计算,那么我们就聚焦到这些行变化的颜色,其实也不算复杂,首先将默认行的背景色改为透明、然后我们再根据变更状态添加对应的行装饰器就可以实现我们需要的效果了

代码实现

  1. 设置diffEditor变化的背景色为透明
    // 覆盖Monaco Editor的默认diff样式
    .monaco-diff-editor .line-insert {
      background-color: transparent !important;
    }

    .monaco-diff-editor .line-delete {
      background-color: transparent !important;
    }

    .monaco-editor .line-insert {
      background-color: transparent !important;
    }

    .monaco-editor .line-delete {
      background-color: transparent !important;
    }

    // 将整行的char-delete和line-delete背景设为透明,但保留字符级别的删除标记
    .monaco-diff-editor .char-delete[style*='width:100%'] {
      background-color: transparent !important;
    }

    .monaco-diff-editor .char-insert[style*='width:100%'] {
      background-color: transparent !important;
    }

    // 简单的diff行样式 - 参考断点行的实现方式
    .diff-line-added {
      background-color: #44ca6240 !important;
    }

    .diff-line-deleted {
      background-color: #f87d7c40 !important;
    }

    .diff-line-modified {
      background-color: #ffad5d40 !important;
    }

    // 暗色主题
    .monaco-editor.vs-dark {
      // 覆盖暗色主题下的Monaco默认样式
      .line-insert {
        background-color: transparent !important;
      }

      .line-delete {
        background-color: transparent !important;
      }

      .diff-line-added {
        background-color: #44ca6260 !important;
      }

      .diff-line-deleted {
        background-color: #f87d7c60 !important;
      }

      .diff-line-modified {
        background-color: #ffad5d60 !important;
      }

      .char-delete[style*='width:100%'] {
        background-color: transparent !important;
      }

      .char-insert[style*='width:100%'] {
        background-color: transparent !important;
      }
    }
  1. 注册DiffEditor编辑器,主要关注的是onMount的处理
   <DiffEditor
    width="900"
    height="300"
    language="javascript"
    theme={
      this.props.colorMode === ColorMode.Light
        ? 'vs-light'
        : 'vs-dark'
    }
    original={leftTest}
    modified={rightTest}
    options={options}
    onMount={this.editorDidMount}
    {...config}
  />
  1. 当编辑器加载完成时,onDidUpdateDiff监听文本变化,然后执行applyCustomDiffDecorations
  editorDidMount(editor, monaco) {
    this.diffEditor = editor
    this.monaco = monaco

    // 调用 onRef 回调,将当前组件实例传递给父组件
    this.onRef(this)

    // 防抖函数,避免频繁调用
    let debounceTimer = null

    // 监听差异更新事件
    editor.onDidUpdateDiff(() => {
      // 清除之前的定时器
      if (debounceTimer) {
        clearTimeout(debounceTimer)
      }

      // 设置新的定时器,延迟执行
      debounceTimer = setTimeout(() => {
        this.applyCustomDiffDecorations()
      }, 100) // 100ms 防抖
    })
  }
  1. 基于monaco的[deltaDecorations]实现行装饰器,stats就是新增删除差异的数据统计
// 应用自定义diff装饰并计算差异统计
  applyCustomDiffDecorations() {
    if (!this.diffEditor || !this.monaco) return
    const lineChanges = this.diffEditor.getLineChanges()

    if (!lineChanges || lineChanges.length === 0) {
      // 清除之前的装饰
      if (this.originalDecorationIds) {
        this.diffEditor
          .getOriginalEditor()
          .deltaDecorations(this.originalDecorationIds, [])
      }
      if (this.modifiedDecorationIds) {
        this.diffEditor
          .getModifiedEditor()
          .deltaDecorations(this.modifiedDecorationIds, [])
      }

      // 重置差异统计
      this.updateDiffStatsIfChanged({
        additions: 0,
        deletions: 0,
        modifications: 0,
      })
      return
    }

    const originalEditor = this.diffEditor.getOriginalEditor()
    const modifiedEditor = this.diffEditor.getModifiedEditor()

    const originalDecorations = []
    const modifiedDecorations = []

    // 差异统计
    const stats = {
      additions: 0,
      deletions: 0,
      modifications: 0,
    }

    // 使用Map来记录每一行的变更类型,避免重复处理
    const allOriginalLineTypes = new Map() // 左侧编辑器行类型
    const allModifiedLineTypes = new Map() // 右侧编辑器行类型

    lineChanges.forEach((change) => {
      const originalStartLine = change.originalStartLineNumber
      const originalEndLine = change.originalEndLineNumber
      const modifiedStartLine = change.modifiedStartLineNumber
      const modifiedEndLine = change.modifiedEndLineNumber

      // 当前变更的行类型
      const originalLineTypes = new Map() // 左侧编辑器行类型
      const modifiedLineTypes = new Map() // 右侧编辑器行类型

      // 根据用户提供的规则进行判断
      if (originalEndLine === 0 && modifiedEndLine > 0) {
        for (let i = modifiedStartLine; i <= modifiedEndLine; i++) {
          modifiedLineTypes.set(i, 'added')
        }
      } else if (originalEndLine > 0 && modifiedEndLine === 0) {
        for (let i = originalStartLine; i <= originalEndLine; i++) {
          originalLineTypes.set(i, 'deleted')
        }
      } else if (originalEndLine > 0 && modifiedEndLine > 0) {
        // 规则3: 两边都有行号,需要根据行数差异判断
        const originalLines = originalEndLine - originalStartLine + 1
        const modifiedLines = modifiedEndLine - modifiedStartLine + 1

        if (originalLines === modifiedLines) {
          // 行数相同,全部标记为修改
          for (let i = originalStartLine; i <= originalEndLine; i++) {
            originalLineTypes.set(i, 'modified')
          }
          for (let i = modifiedStartLine; i <= modifiedEndLine; i++) {
            modifiedLineTypes.set(i, 'modified')
          }
        } else {
          // 行数不同,按照用户规则处理
          const minLines = Math.min(originalLines, modifiedLines)

          if (originalLines > modifiedLines) {
            // 左侧行数更多:对应行标记为修改,多出的左侧行标记为删除
            for (let i = 0; i < minLines; i++) {
              originalLineTypes.set(originalStartLine + i, 'modified')
              modifiedLineTypes.set(modifiedStartLine + i, 'modified')
            }
            // 多出的左侧行标记为删除
            for (let i = minLines; i < originalLines; i++) {
              originalLineTypes.set(originalStartLine + i, 'deleted')
            }
          } else {
            for (let i = 0; i < minLines; i++) {
              originalLineTypes.set(originalStartLine + i, 'modified')
              modifiedLineTypes.set(modifiedStartLine + i, 'modified')
            }
            // 多出的右侧行标记为新增
            for (let i = minLines; i < modifiedLines; i++) {
              modifiedLineTypes.set(modifiedStartLine + i, 'added')
            }
          }
        }
      }

      // 统计各类型行数
      const addedCount = Array.from(modifiedLineTypes.values()).filter(
        (type) => type === 'added',
      ).length
      const deletedCount = Array.from(originalLineTypes.values()).filter(
        (type) => type === 'deleted',
      ).length
      const modifiedCount = Math.max(
        Array.from(originalLineTypes.values()).filter(
          (type) => type === 'modified',
        ).length,
        Array.from(modifiedLineTypes.values()).filter(
          (type) => type === 'modified',
        ).length,
      )

      stats.additions += addedCount
      stats.deletions += deletedCount
      stats.modifications += modifiedCount

      // 将当前变更的行类型合并到全局Map中
      originalLineTypes.forEach((type, lineNumber) => {
        allOriginalLineTypes.set(lineNumber, type)
      })
      modifiedLineTypes.forEach((type, lineNumber) => {
        allModifiedLineTypes.set(lineNumber, type)
      })

      // 根据行类型添加装饰器
      // 处理左侧编辑器
      originalLineTypes.forEach((type, lineNumber) => {
        if (type === 'deleted') {
          // 删除行 - 添加红色背景装饰
          originalDecorations.push({
            range: new this.monaco.Range(lineNumber, 1, lineNumber, 1),
            options: {
              isWholeLine: true,
              className: 'diff-line-deleted',
            },
          })
        } else if (type === 'modified') {
          // 修改行 - 添加橙色背景
          originalDecorations.push({
            range: new this.monaco.Range(lineNumber, 1, lineNumber, 1),
            options: {
              isWholeLine: true,
              className: 'diff-line-modified',
            },
          })
        }
      })

      // 处理右侧编辑器
      modifiedLineTypes.forEach((type, lineNumber) => {
        if (type === 'added') {
          // 新增行 - 添加绿色背景装饰
          modifiedDecorations.push({
            range: new this.monaco.Range(lineNumber, 1, lineNumber, 1),
            options: {
              isWholeLine: true,
              className: 'diff-line-added',
            },
          })
        } else if (type === 'modified') {
          // 修改行 - 添加橙色背景
          modifiedDecorations.push({
            range: new this.monaco.Range(lineNumber, 1, lineNumber, 1),
            options: {
              isWholeLine: true,
              className: 'diff-line-modified',
            },
          })
        }
      })
    })

    // 更新差异统计
    this.updateDiffStatsIfChanged(stats)

    // 应用装饰并保存装饰ID以便后续清理
    this.originalDecorationIds = originalEditor.deltaDecorations(
      this.originalDecorationIds || [],
      originalDecorations,
    )
    this.modifiedDecorationIds = modifiedEditor.deltaDecorations(
      this.modifiedDecorationIds || [],
      modifiedDecorations,
    )
  }

总结

这一节主要讲解了monaco的DiffEditor实现配置文件对比。在这一章我们也初步学习了Monaco的行装饰器的使用,其实编辑器的debugger模式,先基于DAP协议获取到当前debugger的堆栈聚焦行,然后我们在通过行装饰器绘制对应的高亮行。至于堆栈信息只需要绘制对应的堆栈面板接口,是不是感觉就特别清晰了

为什么写这篇文章呢?

  1. 是因为我没有找到相关文章,其他文章都是直接实现DiffEditor效果,并不满足需要的三种状态新增删除差异
  2. 在研发任务排期紧张的时候帮助遇到相同需求的小伙伴减少工作压力,哈哈哈。
❌
❌