调用 getContext("2d") 返回 null 最常见原因是 canvas 未插入 DOM 或 width/height 属性为 0；需确保 canvas 已挂载、尺寸合法、未被 WebGL 等其他上下文独占，且在正确文档上下文中调用。
直接调用 getContext("2d") 就能拿到 2D 渲染上下文，但前提是 <canvas> 元素已挂载、尺寸合法且未被其他上下文（如 "webgl"）独占占用。
为什么调用 getContext("2d") 返回 null
最常见原因是 canvas 尚未插入 DOM 或尚未设置宽高（哪怕 CSS 设置了，width/height 属性仍为 0）。
-
getContext("2d")是只读绑定，一旦被"webgl"或"2d"其他实例占用，再次请求相同类型会成功，但请求冲突类型（如先取了"webgl"，再取"2d"）会返回null - 若 canvas 的
width或height属性值为0（包括未声明、JS 赋值为 0、或被重置），返回值一定是null - 在 iframe 或 Shadow DOM 中获取 canvas 时，需确保执行上下文与 canvas 所属文档一致
正确获取并验证 2D 上下文的写法
不要只依赖 getContext("2d") 的返回值，要显式检查是否为 CanvasRenderingContext2D 实例。
const canvas = document.getElementById("myCanvas");
if (!canvas || !canvas.width || !canvas.height) {
console.error("canvas 缺失 width/height 属性");
return;
}
const ctx = canvas.getContext("2d");
if (!ctx || !(ctx instanceof CanvasRenderingContext2D)) {
console.error("无法获取有效的 2D 上下文");
return;
}
// ✅ 此时 ctx 可安全使用
多次调用 getContext("2d") 是否安全
安全，且推荐复用——它返回的是同一个上下文对象引用，不是新建实例。
立即学习“前端免费学习笔记（深入）”；
- 重复调用不会触发性能开销，也不影响状态（如
fillStyle、save()栈等均保留） - 但要注意：若在异步回调（如
setTimeout、Promise.then）中获取，需确认 canvas 仍存在且未被移除 - 避免在不同模块中各自调用并缓存不同
ctx引用，容易因状态污染导致绘图异常
兼容性与隐式陷阱
getContext("2d") 在所有现代浏览器中都支持，但部分旧安卓 WebView（如 Android 4.3 及更早）对 canvas 尺寸为 0 的容忍度低，即使 JS 后续设了宽高，首次获取仍可能失败。
- 务必在设置
canvas.width和canvas.height后再调用getContext("2d")；CSSwidth/height不影响上下文初始化 - 某些广告 SDK 或监控脚本会偷偷调用
getContext("webgl")占用 canvas，导致你的"2d"请求失败——可在控制台手动执行canvas.getContext("2d")验证 - 服务端渲染（SSR）环境无 canvas，
getContext会报TypeError，需加typeof window !== "undefined"守卫
真正容易被忽略的是 canvas 元素的“可绘制性”不只取决于是否存在，而取决于其内在属性是否满足最低要求——宽高必须是正整数，且不能被其他上下文锁定。调试时优先打印 canvas.width、canvas.height 和 canvas.getContext("2d") 三者值，比查文档更快定位问题。
