马克笔画星空教程：3个致命坑与完整示例，新手必看 刚接手公司那个“手绘星空”前端特效项目时，我盯着屏幕愣了五秒。需求文档上写得明明白白，参考图也是那种细腻的、有笔触质感的夜空。结果呢？我按常规思路写了个 Canvas 渲染循环，跑起来一看，全是生硬的线条，像小学生用尺子画的，毫无“马克笔”那种晕染和覆盖感。 更离谱的是，第二天组长把项目从 Vue 2 升级到 Vue 3 配合 TypeScript 重构。我之前的代码直接废了。this.$refs 没了，beforeMount 改名了，最要命的是，原本封装好的绘图工具类因为依赖了旧的响应式系统，现在完全画不出东西。版本升级后 API 全变了，那一刻我才意识到，光会调包不行，得懂底层逻辑。 这篇马克笔画星空教程，不整虚的。我把自己踩过的坑，结合完整示例，一步步拆解。别管你是用 Canvas 还是 WebGL，核心逻辑是通用的。咱们直接看代码，看怎么把“马克笔”的质感做出来，以及怎么在框架升级时保住你的核心逻辑。 坑一：用“线条”模拟“笔触”，导致画面像铁丝 现象描述 很多新手拿到需求，第一反应是：画线。ctx.beginPath(), ctx.moveTo(), ctx.lineTo(), ctx.stroke()。画完一看，线条太直、太硬，没有宽度变化，也没有那种马克笔涂过纸张的“颗粒感”或“晕染感”。在低分辨率屏幕上，这种线条锯齿严重，完全看不出“星空”的浪漫，倒像是工程图纸。 根本原因 马克笔的物理特性是：笔头有弹性，墨量不均匀，且笔触会有重叠。而 Canvas 的 stroke() 默认是固定宽度的几何线条。你如果只调用一次 stroke，无论怎么调 lineWidth，它都是“死”的。真正的马克笔效果，需要模拟多次、轻微偏移、透明度叠加的绘制过程。 错误写法 vs 正确写法 ❌ 错误写法：一次性描边，生硬且无质感 // 错误示范：简单连线 function drawStarline(ctx, x1, y1, x2, y2) {ctx.beginPath();ctx.moveTo(x1, y1);ctx.lineTo(x2, y2);ctx.lineWidth = 2;ctx.strokeStyle = 'rgba(255, 255, 255, 0.8)';ctx.stroke(); // 问题：只画了一次，线条均匀，无笔触感 }✅ 正确写法：多段微偏移 + 透明度叠加，模拟马克笔覆盖 // 正确示范：模拟马克笔的“涂抹”感 function drawMarkerLine(ctx, x1, y1, x2, y2, color) {const segments = 10; // 将线条分为10段，增加细节const offsetX = (Math.random() - 0.5) * 0.5;const offsetY = (Math.random() - 0.5) * 0.5;ctx.save();ctx.globalAlpha = 0.6; // 降低透明度，让重叠处更实ctx.lineCap = 'round'; // 圆头，更像笔尖ctx.lineJoin = 'round';ctx.strokeStyle = color;ctx.lineWidth = 1.5 + Math.random() * 0.5; // 宽度微随机for (let i = 0; i segments; i++) {const t1 = i / segments;const t2 = (i + 1) / segments;// 加入微小的随机扰动，模拟手绘抖动const jitter1 = () = (Math.random() - 0.5) * 1.5;const x1s = x1 + (x2 - x1) * t1 + jitter1();const y1s = y1 + (y2 - y1) * t1 + jitter1();const x2s = x1 + (x2 - x1) * t2 + jitter1();const y2s = y1 + (y2 - y1) * t2 + jitter1();ctx.beginPath();ctx.moveTo(x1s + offsetX, y1s + offsetY);ctx.lineTo(x2s + offsetX, y2s + offsetY);ctx.stroke();}ctx.restore(); }解析：注意 jitter1() 和 offsetX/Y。我们通过把一条长线拆成多段短线，并在每段端点加入随机扰动，模拟人手绘图的微小抖动。配合 globalAlpha 的叠加，重叠部分颜色会变深，这正是马克笔墨水在纸上累积的效果。 坑二：框架升级后，Canvas 实例丢失导致渲染中断 现象描述 这是最让人头疼的坑。项目从 Vue 2 升级到 Vue 3，或者从 React 17 升级到 18 时，很多开发者发现星空动画突然卡死，或者只画了一半就停了。控制台没有报错，但画面静止。 根本原因 在 Vue 2 或旧版 React 中，我们习惯用 this.$refs.canvas 获取 DOM 元素。但在 Vue 3 的组合式 API 或 React 的严格模式下，组件的重渲染机制变了。如果 canvas 元素被条件渲染（如 v-if）或者在父组件重新挂载时，旧的 ctx 上下文引用可能指向了一个已经销毁或重置的 DOM 节点。更隐蔽的是，Resize 监听器未解绑，导致在组件卸载后仍在尝试绘制，或者在新组件挂载时，旧的事件监听器仍在干扰新实例。 复现与修复代码 ❌ 错误写法：直接持有引用，未处理生命周期 // Vue 2 风格写法，在 Vue 3 script setup 中极易出问题 let canvas; let ctx;function initCanvas() {// 问题：直接赋值，如果 DOM 重渲染，canvas 变量指向旧节点canvas = document.getElementById('star-canvas'); ctx = canvas.getContext('2d');startAnimation(); // 启动动画 }// 没有对应的清理逻辑，组件卸载后动画可能继续跑，或引用失效✅ 正确写法：使用 Ref 绑定 + 显式清理 + 防抖初始化 import { ref, onMounted, onUnmounted } from 'vue';const canvasRef = refHTMLCanvasElement(null); let animationFrameId: number | null = null; let resizeObserver: ResizeObserver | null = null;function initCanvas() {if (!canvasRef.value) return;// 确保获取的是当前有效的 DOM 元素const canvas = canvasRef.value;const ctx = canvas.getContext('2d');// 设置高分屏适配，避免模糊const dpr = window.devicePixelRatio || 1;const rect = canvas.getBoundingClientRect();canvas.width = rect.width * dpr;canvas.height = rect.height * dpr;ctx.scale(dpr, dpr);// 启动动画startAnimation(ctx, canvas.width / dpr, canvas.height / dpr);// 监听容器大小变化，动态调整 CanvasresizeObserver = new ResizeObserver(() = {if (canvasRef.value) {const newRect = canvasRef.value.getBoundingClientRect();canvas.width = newRect.width * dpr;canvas.height = newRect.height * dpr;ctx.scale(dpr, dpr);// 这里需要重新初始化星空数据，或者只重绘背景}});if (canvasRef.value.parentElement) {resizeObserver.observe(canvasRef.value.parentElement);} }function startAnimation(ctx: CanvasRenderingContext2D, width: number, height: number) {// 绘制逻辑...animationFrameId = requestAnimationFrame(() = {// 每一帧清除上一帧ctx.clearRect(0, 0, width, height);// ... 绘制星空和马克笔线条startAnimation(ctx, width, height);}); }onMounted(() = {initCanvas(); });onUnmounted(() = {// 关键：必须清理，否则内存泄漏且动画不停if (animationFrameId) cancelAnimationFrame(animationFrameId);if (resizeObserver) resizeObserver.disconnect();animationFrameId = null;resizeObserver = null; });解析：核心在于 onUnmounted 中的清理。很多“API 变了”的问题，本质是生命周期管理的问题。Vue 3 的 onUnmounted 比 Vue 2 的 beforeDestroy 更明确地标识了清理时机。此外，使用 ResizeObserver 代替 window.resize 监听，能更精确地响应容器变化，这是现代前端开发的标准做法，参考 MDN 关于 ResizeObserver 的开发者文档，它能避免布局抖动导致的 Canvas 比例失调。 坑三：性能陷阱：每帧重绘全量星星导致掉帧 现象描述 在低端手机或旧笔记本上，星空动画明显卡顿，帧率从 60fps 掉到 20fps 以下。用户滑动页面时，动画直接冻结。 根本原因 为了实现“星空闪烁”或“星星移动”，很多开发者在 requestAnimationFrame 的回调里，每一帧都重新生成随机星星的位置、大小、颜色，并遍历所有星星进行绘制。如果星星数量超过 500 个，加上马克笔线条的复杂计算，主线程会被阻塞。 进阶技巧与避坑分层绘制：将静态背景（如深色渐变、固定的大星星）画在离屏 Canvas 或静态 DOM 上，只让动态元素（闪烁的小星星、移动的笔触）在主 Canvas 上更新。 对象池复用：不要每帧 new Star()，而是预先生成一批星星对象，只更新它们的 alpha 或 y 坐标。 批量绘制：对于相同样式的星星，尽量合并 Path。虽然 Canvas 2D 的批量绘制优化有限，但减少 beginPath 和 fill 的调用次数依然有效。优化前后代码对比 ❌ 错误写法：每帧随机生成 function drawStars(ctx, width, height) {for (let i = 0; i 200; i++) {// 问题：每帧都随机生成，星星位置会疯狂跳动，且计算量大const x = Math.random() * width;const y = Math.random() * height;const r = Math.random() * 1.5;ctx.fillStyle = `rgba(255,255,255,${Math.random()})`;ctx.beginPath();ctx.arc(x, y, r, 0, Math.PI * 2);ctx.fill();} }✅ 正确写法：预生成 + 状态更新 class Star {constructor(width, height) {this.x = Math.random() * width;this.y = Math.random() * height;this.r = Math.random() * 1.5;this.alpha = Math.random();this.fadeSpeed = (Math.random() - 0.5) * 0.02;}update() {this.alpha += this.fadeSpeed;if (this.alpha 1 || this.alpha 0) {this.fadeSpeed *= -1; // 闪烁效果}} }let stars: Star[] = []; function initStars(width, height) {stars = [];for (let i = 0; i 200; i++) {stars.push(new Star(width, height));} }function drawStars(ctx, width, height) {// 遍历预生成的星星for (const star of stars) {star.update(); // 只更新状态，不重新生成ctx.fillStyle = `rgba(255,255,255,${Math.max(0, Math.min(1, star.alpha))})`;ctx.beginPath();ctx.arc(star.x, star.y, star.r, 0, Math.PI * 2);ctx.fill();} }规避建议：如何构建可维护的绘图模块解耦逻辑与视图：不要把绘图逻辑直接写在 Vue/React 组件里。封装一个 StarSkyRenderer 类，它只接收 Canvas 上下文和配置参数。组件只负责生命周期管理和传递参数。这样，无论前端框架怎么升级，只要 Canvas API 不变，你的核心逻辑就能复用。 使用 TypeScript 定义接口：定义 StarConfig、PenStyle 等接口，让配置可序列化。这样在调试时，你可以把配置参数存下来，方便复现问题。 参考权威文档：在处理高分屏适配、Canvas 性能优化时，务必查阅 MDN Web Docs 中的 Canvas API 章节。特别是 ctx.imageSmoothingEnabled 和 devicePixelRatio 的处理，这些细节往往决定了画面的清晰度。结语 马克笔画星空，看似简单，实则是对前端图形渲染、生命周期管理、性能优化的综合考验。版本升级带来的 API 变更，往往只是表象，深层问题在于你对底层机制的理解是否足够深刻。 我在项目中通过上述方法，将帧率稳定在 60fps，且兼容了 Vue 2 到 Vue 3 的迁移。代码不再因为框架变动而频繁重写，因为核心渲染逻辑是独立的。 你公司项目里是怎么处理 Canvas 动画性能优化的？或者在框架迁移时遇到过哪些更隐蔽的坑？欢迎评论区交流，咱们一起避坑。