Dart中String调用contains方法报错：方法未定义，如何解决？

原因分析 #

Dart标准库的String类原生就提供了contains方法，出现"The method 'contains' isn't defined for the type 'String'"错误，核心原因是命名冲突：

• 你可能导入了某个第三方库、自定义扩展文件，其中的代码给String添加了同名扩展方法，覆盖了原生的contains；
• VS Code提示的oscontains大概率是来自IO相关库衍生的扩展方法，属于编辑器误关联的提示，并非原生解决方案。

解决步骤 #

1. 排查导入语句
   检查代码顶部的import，看看有没有导入非必要的第三方库或自定义扩展，尤其是包含extension String on String的文件，这类代码可能意外覆盖了原生方法。

2. 强制调用原生方法
   如果暂时无法找到冲突源，可以通过强制类型转换确保调用原生String的方法：

   String isPdf = "https://www.africau.edu/images/default/sample.pdf";
   bool hasPdf = (isPdf as String).contains("pdf");
   

3. 修复编辑器误提示
   重启VS Code或执行「重新加载窗口」（快捷键Ctrl+Shift+P，输入Reload Window），清理语言服务缓存，解决编辑器的错误提示问题。

4. 检查SDK版本
   确保使用Dart 2.0及以上版本（当前主流版本都满足），旧版SDK可能存在方法缺失的情况。

5. 排查自定义扩展
   检查自己编写的代码中是否有extension String on String的扩展块，确认是否错误定义了contains方法，如有则修改或删除该扩展。

内容的提问来源于stack exchange，提问作者shajahan