根本原因是think-cli全局安装后其bin路径未加入系统PATH，且think命令必须在合法ThinkPHP项目根目录下执行；需手动配置PATH并确认项目结构完整。
ThinkPHP 的 think 命令无法全局调用，根本原因不是没装，而是 composer global require topthink/think-cli 装完后，think 可执行文件没进系统 PATH —— 这是 Windows/macOS/Linux 三端共有的硬性前提，跳过它，所有后续命令都无效。
确认 think-cli 是否真被全局安装成功
很多人以为运行了 composer global require topthink/think-cli 就万事大吉，其实这只是第一步。它只把包放进全局 vendor 目录，并在 vendor/bin 下生成软链接（或可执行脚本），但不会自动让终端识别这个命令。
- 先查全局安装根目录：
composer config --global home，输出类似C:\Users\Alice\AppData\Roaming\Composer（Windows）或/home/alice/.composer（Linux/macOS） - 再确认
think文件是否真实存在：ls -l $(composer config --global home)/vendor/bin/think（macOS/Linux）或dir %APPDATA%\Composer\vendor\bin\think.*（Windows） - 如果文件不存在，说明安装失败；如果存在但
think命令仍报错，问题一定出在PATH
Windows 下必须手动加 %APPDATA%\Composer\vendor\bin 到用户 PATH
Windows 的 CMD/PowerShell 不解析环境变量路径，所以不能填 %APPDATA%\Composer\vendor\bin，必须展开为绝对路径——比如 C:\Users\Alice\AppData\Roaming\Composer\vendor\bin。这是最常踩的坑。
- 打开「系统属性 → 高级 → 环境变量」，在「用户变量」的
Path中点击「编辑」→「新建」 - 粘贴完整路径（注意：不是
%APPDATA%，也不是~\AppData\Roaming\...） - 保存后，**必须关闭所有已打开的 CMD/PowerShell 窗口，重新打开一个**，再运行
echo %PATH%确认该路径已出现在输出中 - 验证是否生效：
where think应返回该 bin 路径下的think.bat或think文件
Linux/macOS 下 PATH 配置容易漏掉 source 或写错 shell 配置文件
macOS Catalina 及以后默认用 zsh，但很多人还在改 ~/.bash_profile，结果配置不生效；Linux 用户则常忽略 chmod +x 权限问题。
- 先确认当前 shell：
echo $SHELL，zsh 用户改~/.zshrc，bash 用户改~/.bashrc或~/.bash_profile - 在对应文件末尾添加：
export PATH="$HOME/.composer/vendor/bin:$PATH" - 立即生效：
source ~/.zshrc（或对应文件），别只改不 reload - 检查权限：
ls -l ~/.composer/vendor/bin/think，若无x标志，运行chmod +x ~/.composer/vendor/bin/think - 验证：
which think应返回路径，think -V应输出 ThinkPHP CLI 版本号
think 命令能跑但提示 Class 'think\App' not found？那是项目结构错了
全局安装 think-cli 只提供命令行工具，不等于你就能在任意目录下直接运行 think make:controller。它必须作用于一个合法的 ThinkPHP 项目内部，否则自动加载失败。
-
think命令本身是全局可用的，但它的所有子命令（如make:controller、route:list）都依赖当前目录下存在标准 TP 项目结构（含vendor/autoload.php和think入口文件） - 正确做法：先用
composer create-project topthink/think myapp创建完整项目，再cd myapp，最后执行think make:controller Index - 如果在空目录或非 TP 项目里强行运行，会报
Class 'think\App' not found或require(): failed to open stream: No such file—— 这不是think-cli的问题，是上下文缺失
真正卡住人的，从来不是“怎么装”，而是“装完之后 PATH 没生效”和“误以为命令能脱离项目运行”。这两点不盯死，反复重装都没用。
