HarmonyOS StrUtil 字符串判空三兄弟：isNull、isEmpty、isBlank 到底有啥区别？

背景

近期发现一款很有意思的HarmonyOS 三方库, 地址 @pura/harmony-utils(V1.4.0) , 作者是"桃花镇童长老", 我这里也是直接通过该作者公布的源码进行案例编写进行,写了到目前写了一部分demo ,感觉确实很有帮助,这里呢也是开始写一个系列的演示demo 供大家参考。如有帮助可以在OpenHarmony中进行下载安装进行使用哦

案例demo导航展示

↓↓↓↓↓↓接下来言归正传 ↓↓↓↓
搞 HarmonyOS 开发，字符串判空是绕不过去的坎。很多初学者写代码的时候，遇到空值处理就习惯性地写if (str === null || str === undefined || str === '')这一长串。烦不烦？

HoUtils 里的StrUtil提供了三个判空方法，名字看着像，实际行为差别挺大。今天就把这三兄弟说清楚。

方法总览

isNull：只管"有没有值"

isNull只判断一件事：这个变量是不是null或者undefined。

注意，它不管字符串内容，哪怕你传个空字符串""，它也返回false，因为空字符串是一个合法的值，不是 null。

// 点击按钮触发，直接从 Demo 日志中对应this.addLog(`isNull("${this.inputStr}") →${StrUtil.isNull(this.inputStr)}`);this.addLog(`isNull(null) →${StrUtil.isNull(null)}`);this.addLog(`isNull(undefined) →${StrUtil.isNull(undefined)}`);

实际运行结果：

• isNull(" Hello HarmonyOS ")→false（有值，不是 null）
• isNull(null)→true（就是 null）
• isNull(undefined)→true（undefined 也算）

对应的isNotNull就是取反，传进去不是 null/undefined 就返回 true。

this.addLog(`isNotNull("${this.inputStr}") →${StrUtil.isNotNull(this.inputStr)}`);

isEmpty：判断"有没有内容"

isEmpty比isNull严格一点，它不只检查 null，还检查字符串是否为空字符串""。

但注意，isEmpty不处理空白字符。你传一个全是空格的字符串" "，它也会返回false，因为那个字符串有内容（虽然是空格）。

this.addLog(`isEmpty("${this.inputStr}") →${StrUtil.isEmpty(this.inputStr)}`);this.addLog(`isEmpty("") →${StrUtil.isEmpty('')}`);

实际运行结果：

• isEmpty(" Hello HarmonyOS ")→false（有内容）
• isEmpty("")→true（空字符串）
• isEmpty(null)→ 很多实现里也返回true，因为没有内容

对应的isNotEmpty就是非空才返回 true：

this.addLog(`isNotEmpty("${this.inputStr}") →${StrUtil.isNotEmpty(this.inputStr)}`);

isBlank：最严格的那个，连空格也不放过

isBlank是三兄弟里最"挑剔"的。它不只检查 null 和空字符串，还会检查字符串是否全为空白字符（空格、制表符等）。

this.addLog(`isBlank("${this.inputStr}") →${StrUtil.isBlank(this.inputStr)}`);this.addLog(`isBlank(" ") →${StrUtil.isBlank(' ')}`);

实际运行结果：

• isBlank(" Hello HarmonyOS ")→false（虽然有空格，但有实际内容）
• isBlank(" ")→true（全是空格，当空白处理）
• isBlank("")→true
• isBlank(null)→true

对应的isNotBlank就是真正有可见内容才返回 true：

this.addLog(`isNotBlank("${this.inputStr}") →${StrUtil.isNotBlank(this.inputStr)}`);

三个方法的对比一览

什么场景用哪个？

用isNull：你只想区分"有没有传参"，null 和 undefined 需要特殊处理，但空字符串是合法值的场景。比如接口返回值检查。

用isEmpty：你需要确保字符串有内容，但空白字符对你来说也有意义的场景。比如密码字段——密码是空格也算有输入。

用isBlank：表单验证场景。用户只输入了空格，你肯定想拦截，这时候用isBlank最合适。比如用户名输入框、搜索框。

完整 Demo 代码

完整的 Demo 页面代码如下，可以直接在 HarmonyOS 项目中运行：

importrouterfrom'@ohos.router';import{StrUtil}from'../Utils/StrUtil';interfaceLogItem{time:string;text:string;}@Entry@Componentstruct StrUtilDemoPage{@Statelogs:LogItem[]=[];@StateinputStr:string=' Hello HarmonyOS ';privateaddLog(text:string){constd=newDate();consttime=`${d.getHours().toString().padStart(2,'0')}:${d.getMinutes().toString().padStart(2,'0')}:${d.getSeconds().toString().padStart(2,'0')}`;constnewItem:LogItem={time,text};this.logs=([newItem]asLogItem[]).concat(this.logs).slice(0,60);}build(){Column(){// isNull / isNotNullButton('isNull(null)').onClick(()=>{this.addLog(`isNull(null) →${StrUtil.isNull(null)}`);})Button('isNull(undefined)').onClick(()=>{this.addLog(`isNull(undefined) →${StrUtil.isNull(undefined)}`);})Button('isEmpty("")').onClick(()=>{this.addLog(`isEmpty("") →${StrUtil.isEmpty('')}`);})Button('isBlank(" ") 全空格').onClick(()=>{this.addLog(`isBlank(" ") →${StrUtil.isBlank(' ')}`);})Button('isNotBlank("hello")').onClick(()=>{this.addLog(`isNotBlank("hello") →${StrUtil.isNotBlank('hello')}`);})}}}

写在最后

这三个方法说起来简单，但真正搞清楚差别能帮你少踩很多坑。

最常见的错误就是在表单验证里用了isEmpty，结果用户输入一串空格也通过了检查。改成isBlank就能正确拦截。

下一篇我们聊trim和trimAll——去空格也有讲究。