laravel 的 str 类不是 php 原生函数，必须通过 use illuminate\support\str; 引入，且依赖框架自动加载和 utf-8 编码；str::slug() 报错因类未引入或框架未启动，str::of() 返回可链式 stringable 实例，而静态方法返回原始类型。
直接说结论：Laravel 的 Str 类不是 PHP 原生函数，必须通过 use Illuminate\Support\Str; 引入，且不能在全局作用域或未加载 Laravel 框架的环境中直接调用。
为什么 Str::slug() 会报 “Class 'Str' not found”？
这是最常遇到的错误，本质是类未引入或框架未启动。Laravel 的 Str 是一个静态工具类，不注册全局函数，也不自动加载。
- 没加
use Illuminate\Support\Str;—— 即使在 Laravel 项目里也必须显式引入 - 在纯 PHP 脚本（如
test.php）中直接写Str::lower('HELLO')—— 框架服务容器、自动加载器都没启动，Illuminate\Support\Str根本不可见 - 用了别名但拼错，比如写成
use Illuminate\Support\String;（正确是Str）
Str::of() 和传统静态调用（如 Str::upper()）有什么区别？
Str::of() 返回一个可链式调用的 Illuminate\Support\Stringable 实例，适合多步字符串处理；而传统静态方法是一次性操作，返回原始类型（string/int/bool）。
-
Str::upper('hello')->limit(3)❌ 错误：Str::upper()返回 string，没有limit()方法 -
Str::of('hello world')->upper()->limit(8)->append('...')✅ 返回Stringable，支持链式 - 性能差异极小，但
Stringable在复杂处理中更易读、不易出错
哪些 Str 方法容易踩坑？
部分方法行为和直觉不符，尤其涉及编码、空格、边界判断时：
-
Str::contains('café', 'é')默认使用 UTF-8，但若传入的字符串实际是 ISO-8859-1 编码，结果不可靠 —— 确保输入统一为 UTF-8 -
Str::words('Hello world!', 1)截取后默认加'...'，想不加得写Str::words('Hello world!', 1, '') -
Str::slug('Laravel 7.x')生成laravel-7x（点号被丢弃），如果需要保留分隔符，得先str_replace('.', '-', $str)再 slug -
Str::startsWith(['http://', 'https://'], $url)参数顺序反了 —— 正确是Str::startsWith($url, ['http://', 'https://'])
真正麻烦的从来不是记不住方法名，而是忘了 Stringable 链式调用要从 Str::of() 开始，以及所有 Str 工具都依赖 Laravel 的自动加载和字符编码假设。没引入、没 UTF-8、没链式起点，三个条件缺一不可。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
