ThinkPHP新手快速上手：环境变量一键配置与Composer验证

刚安装完 PHPStudy 和 Composer，兴冲冲地在 CMD 中输入php -v或composer -v，结果却收到一盆冷水——“不是内部或外部命令”。别担心，这通常不是你的操作失误，而是系统环境变量中没有包含这些程序的关键路径。手动将所需目录添加到系统环境变量中，命令行才能正确识别它们。

确认 PHP 是否已安装并正确配置 Path

打开 CMD 直接输入php -v。如果提示“不是内部或外部命令”，说明 PHP 的路径尚未写入系统环境变量。请先定位 PHPStudy 中当前启用的 PHP 版本所在目录，例如 D:\phpstudy_pro\Extensions\php\php8.0.2nts（具体路径以你的实际安装位置为准）。

右键点击“此电脑”→属性→高级系统设置→环境变量→在“系统变量”中找到并双击Path→点击“新建”→粘贴刚才复制的 PHP 完整路径→点击确定保存所有更改。

务必重启 CMD 窗口：旧终端会缓存启动时的 PATH 变量，不关闭重开，新路径无法生效。重新打开 CMD，再执行php -v，若显示 PHP 版本号即表示配置成功。

验证并解决 Composer 命令不可用的问题

方法一：检查 Composer 是否被系统正确识别

在 CMD 中运行composer -V（注意是大写 V）。如果报错，先别急着重装——90% 的情况是由于 PATH 中遗漏了 Composer 的 bin 目录。

方法二：手动添加 Composer 全局 bin 路径

Composer 安装完成后，其可执行文件实际存储在%APPDATA%\Composer\vendor\bin目录下。这个路径必须显式添加到系统 PATH 中。进入环境变量设置→在“用户变量”的Path中新增一行：%APPDATA%\Composer\vendor\bin→保存并退出。

方法三：解决 Composer-Setup.exe 未自动写入 PATH 的典型失败场景

运行echo %PATH%，搜索ComposerSetup\bin。如果未找到，说明官方安装器在 UAC 受限或 PowerShell 策略严格的环境中跳过了 PATH 写入。此时需要手动添加系统级 PATH：C:\ProgramData\ComposerSetup\bin。这是 Composer 主程序composer.bat的实际存放位置，缺少该路径会导致任何全局命令都无法调用。

强制刷新并交叉验证两个核心命令

第一步：关闭所有已打开的 CMD、PowerShell、IDE 终端窗口。

第二步：全新启动 CMD，依次执行以下三行命令：

php -v
composer -V
composer config --list --global

第三步：观察输出。前三行都应该正常返回版本信息或配置列表；如果其中任何一个命令仍然报错，说明对应的路径未生效或存在拼写错误，需仔细检查路径中的盘符、斜杠方向、空格及中文字符。

第四步：执行composer global require topthink/think-cli，完成后直接输入think -V。如果能输出 ThinkPHP CLI 版本，恭喜——整个链路（PHP→Composer→ThinkCLI）已全部打通。