Canvas中createLinearGradient画不出渐变，主因是坐标系理解错误、变换干扰、色标offset超范围（须0–1）、未适配devicePixelRatio及resize后未更新渐变坐标。

canvas 里 createLinearGradient 画不出渐变？先看坐标系是否搞反了

Canvas 的渐变不是“从颜色 A 到颜色 B”就完事，它严格依赖起点 (x0, y0) 和终点 (x1, y1) 构成的线段方向。常见错误是以为 createLinearGradient(0, 0, 100, 0) 就是“从左到右”，但实际效果取决于你 fillRect 的位置和 canvas 坐标系原点（左上角）。如果画布没重置、或用 transform 移动过，起点/终点坐标可能被意外偏移。

• 始终用绝对像素坐标（比如 0, 0, canvas.width, 0 表示横向全宽渐变）
• 避免在调用 createLinearGradient 前使用 ctx.save()/ctx.translate() 等变换，除非你明确知道它们会影响渐变线段坐标
• 调试时可临时用 ctx.strokeStyle = 'red'; ctx.beginPath(); ctx.moveTo(x0,y0); ctx.lineTo(x1,y1); ctx.stroke(); 画出渐变轴线，确认方向是否符合预期

添加多个色标必须用 addColorStop，且 offset 必须在 0–1 范围内

addColorStop 的第一个参数是归一化偏移量（0.0 到 1.0），不是像素值。很多人写成 grad.addColorStop(50, '#f00') 或 grad.addColorStop(-0.1, '#000')，结果静默失败——浏览器不会报错，但该色标直接被忽略，导致渐变断层或单色填充。

• 色标顺序不强制按 offset 升序，但建议保持，否则渲染行为可能因浏览器而异
• 至少要加两个色标（0 和 1），否则渐变无效
• 可以重复使用同一 offset（比如模拟硬边过渡：addColorStop(0.5, '#f00'); addColorStop(0.5, '#00f');）

const grad = ctx.createLinearGradient(0, 0, 200, 0);
grad.addColorStop(0, '#ff9a9e');   // 左端
grad.addColorStop(0.5, '#fad0c4'); // 中间
grad.addColorStop(1, '#a1c4fd');   // 右端
ctx.fillStyle = grad;
ctx.fillRect(0, 0, 200, 100);

渐变对象不能复用？其实是能的，但要注意 fillStyle 的赋值时机

createLinearGradient 返回的是一个 CanvasGradient 对象，它本身不绑定画布尺寸或绘制内容，只要坐标逻辑合理，完全可以复用。问题常出在：你在 canvas resize 后没更新渐变坐标，却还用旧的 grad 对象，导致渐变拉伸变形或偏移。

• 如果 canvas 尺寸会变（如响应式布局），每次重绘前应重新创建渐变，或封装成函数动态计算 (x0,y0,x1,y1)
• 不要把 ctx.fillStyle = grad 写在初始化阶段，而应在每次绘制前设置，避免因上下文状态残留导致意外覆盖
• 渐变对象没有「销毁」概念，也不需要手动释放，但大量动态创建时注意别在闭包中意外持有 canvas 引用造成内存泄漏

移动端 Safari 或老版 Chrome 渐变失效？检查 CSS transform 和 devicePixelRatio

某些 iOS Safari 版本对带 transform: scale() 的 canvas 容器中渲染渐变有 bug；更常见的是高 DPI 设备（如 Retina 屏）下，若 canvas 的 width/height 属性没按 devicePixelRatio 缩放，而 CSS 样式又设置了 width: 100%; height: 100%，会导致渐变坐标被拉伸，看起来像“只显示一半”或“颜色挤在一起”。

立即学习“前端免费学习笔记（深入）”；

• 务必显式设置 canvas 元素的 width 和 height 属性（不是 CSS 样式），并乘以 window.devicePixelRatio
• 避免对 canvas 父容器使用 transform，改用 position + top/left 控制位置
• 测试时用 console.log(ctx.fillStyle) 看是否仍为 CanvasGradient 实例，排除被意外覆盖成字符串颜色的可能

渐变坐标的归一化逻辑和设备像素适配是真正容易漏掉的环节，尤其在动态尺寸场景下，光写对 addColorStop 不代表能稳定出图。

# console  # 你在  # 多个  # 第一个  # 也不  # 升序  # 左端  # 复用  # 不出  # 的是  # 色标  # bug  # canvas  # transform  # position  # 对象  # css  # 闭包  # 字符串  # 封装  # chrome  # red  # canva  # 重绘  # 响应式布局  # win  # ios  # safari  # 浏览器  # html5  # html 

相关文章： Python异步编程详解_asyncio协程实现与性能优化  海尔专卖店深化数字转型实现80%统仓ToC  Go 中 Goroutine 死锁问题的根源与正确解决方法  包子漫画手机版在线入口 包子漫画最新章节抢先看入口  Windows怎样关闭桌面弹窗广告_Windows关闭桌面弹窗设置【教程】  猎豹浏览器开发者工具怎么打开 猎豹浏览器F12调试工具使用【前端必备】  steam网页版登录官方入口_steam官网网页端实时访问教程  如何使用Golang掌握包使用_Golangimport与包管理实践  php静态变量怎么调试_php静态变量作用域调试技巧【解答】  HTML透明颜色代码在Angular里怎么设置_Angular透明颜色使用指南【详解】  IE浏览器怎样启用弹出窗口拦截_IE浏览器弹窗拦截开启【教程】  快手网页版入口 电脑大屏更过瘾  怎样使用JSON进行数据交换_它有什么限制  LinuxKubernetes调度机制教程_亲和性与资源分配  VSCode的PHP Intelephense：智能PHP代码补全  独特背插供电！蓝宝石NITRO+氮动RX 9070 XT显卡图赏  manwa漫蛙网页版入口_蛙漫在线看免费漫画  哈迪斯入门双流派全解 通关加点技巧分享  ChatGPT常用指令模板大全 新手快速上手的万能Prompt合集  如何在 Vue 3 中正确传递和使用 props（含模板语法与注意事项）  如何使用 Go 正则表达式提取括号内首个纯字母标识符（排除嵌套与后续重复）  Owlcat官宣推出自家启动器 玩家社区炸锅：不需要！  PHP怎么接收前端传的布尔值_处理truefalse参数转换方法指南【解答】  Linux系统巡检体系建设教程_自动化巡检落地方案  Win11怎样安装网易有道词典_Win11安装词典教程【步骤】  AMD春雨计划走进北京大学、北京交通大学 以全栈式AI解决方案赋能AI学习与创新  如何实现Javascript的无限滚动_怎样用Javascript优化长列表渲染？  wpsPDF在线编辑入口 wps网页版PDF工具直达  淘宝闪购入口在哪找？淘宝闪购官方限时抢购频道一键直达  海棠搜书官网入口直接进 海棠文化在线阅读官方网站入口 

相关栏目： 【 行业资讯17850 】 【 软件资源51899 】 【 网站技术89748 】 【 百度推广44206 】 【 网络营销84187 】 【 运营推广93002 】 【 AI优化91086 】 【 网络优化117696 】 【 网址导航107142 】