报错原文ERROR: 10505001 ArkTS Compiler Error Error Message: Cannot find namespace image. At File: xxx.ets:N:N报错触发场景你写鸿蒙 ArkTS 处理图片时直接用image.createImageSource/image.PixelMap/image.Size不 import 就炸// ❌ 报错写法asyncmakeThumb():Promiseimage.PixelMap{← image 命名空间未importconstsrc:image.ImageSourceimage.createImageSource(buf)returnsrc.createPixelMap()}根因鸿蒙 ArkTS 的image命名空间不是全局名——它定义在ohos.multimedia.image模块里必须显式 import 才能用。image命名空间下有大量图片处理类型和 APIimage.createImageSource/image.createPixelMap/image.ImageSource/image.PixelMap/image.Size/image.InitializationOptions/image.PixelMapFormat等。新手最容易踩的坑肌肉记忆直接用image.xxx编译就报「Cannot find namespace ‘image’」。ArkTS 这么设计的原因按 ES Module 规范设计——每个模块要显式 import避免全局名污染。代价是多写一行 import但模块化更清晰。真解法一种解法显式 import// ✅ 正解importimagefromohos.multimedia.imageasyncmakeThumb(buf:ArrayBuffer):Promiseimage.PixelMap{constsrc:image.ImageSourceimage.createImageSource(buf)constinfo:image.ImageInfoawaitsrc.getImageInfo()constopts:image.InitializationOptions{size:{width:200,height:200},pixelFormat:image.PixelMapFormat.RGBA_8888,editable:false,alphaType:0}asimage.InitializationOptionsconstpm:image.PixelMapawaitsrc.createPixelMap(opts)src.release()returnpm}import image from ohos.multimedia.image——import 整个命名空间不是{ }解构单个符号。真机配图import 正解能编译能跑import image后——正解能编译能跑。三个 image API 都真能调import 正解初始态createImageSource/makeSize/createPixelMap 均未调用点调三个 API 后都真调了日志更新「第 3 次createPixelMap 调用完」报错写法忘 import编译就炸装不上真机正解写法显式 import能跑三个 image API 都真能调。忘 import 就炸import 了就跑——这是 image 命名空间非全局最直白的证据。高频踩坑场景场景 1image.createImageSource忘 import// ❌ 报错constsrcimage.createImageSource(buf)// ✅ 正解importimagefromohos.multimedia.imageconstsrc:image.ImageSourceimage.createImageSource(buf)场景 2image.PixelMap类型忘 import// ❌ 报错类型用 image 命名空间未 importasyncfn():Promiseimage.PixelMap{...}// ✅ 正解importimagefromohos.multimedia.imageasyncfn():Promiseimage.PixelMap{...}场景 3photoAccessHelper里image.PixelMap也要 import// ❌ 报错photoAccessHelper.getThumbnail 返 image.PixelMapimage 未 importimportphotoAccessHelperfromohos.file.photoAccessHelperconstpm:image.PixelMapawaitasset.getThumbnail({width:200,height:200})// ✅ 正解两个模块都 importimportphotoAccessHelperfromohos.file.photoAccessHelperimportimagefromohos.multimedia.imageconstpm:image.PixelMapawaitasset.getThumbnail({width:200,height:200})场景 4image.InitializationOptions字段写错// ❌ 报错字段名 srcSize 不存在constopts:image.InitializationOptions{srcSize:{width:100,height:100}← 报错字段叫 size 不叫 srcSize}asimage.InitializationOptions// ✅ 正解字段名 sizeconstopts:image.InitializationOptions{size:{width:100,height:100},pixelFormat:image.PixelMapFormat.RGBA_8888,editable:false,alphaType:0}asimage.InitializationOptions一句话速查Cannot find namespace ‘image’ → 忘 import加import image from ohos.multimedia.imageimage 命名空间速查表API/类型用途import 吗image.createImageSource从 buf/fd 创 ImageSource要image.createPixelMap创 PixelMap要image.ImageSource图片源类型要image.PixelMap位图类型要image.Size{width, height}要image.InitializationOptionsPixelMap 创配置要image.PixelMapFormat格式枚举要铁律用image.xxx命名空间下任何 API/类型必须import image from ohos.multimedia.image。完整代码仓库本文所有正解写法都已托管到AtomGit仓库地址https://atomgit.com/JaneConan/arkui-bug-image-no-import仓库包含四种高频踩坑场景的 ❌ 报错写法 ✅ 正解写法对照image命名空间速查表可直接用 DevEco Studio 打开参考作者JaneConan仓库https://atomgit.com/JaneConan/arkui-bug-image-no-import协议Apache-2.0随便用别告我
