“php webman start”报错源于未在项目根目录执行、webman脚本缺失/无权限/换行符错误或依赖未安装，需依次确认路径、文件存在性、权限、shebang、vendor/autoload.php加载及换行格式。
如果您在终端中执行 php webman start 时提示“command not found”或“could not open input file webman”，则说明系统无法识别该命令，通常源于可执行文件缺失、路径错误或权限配置不当。以下是针对性排查与修复步骤：
一、确认 webman 命令是否存在于项目根目录
Webman 的 webman 命令是一个位于项目根目录下的可执行脚本（非全局安装的 CLI 工具），并非通过 Composer 全局 bin 注册。若当前不在项目根目录下运行，系统将无法定位该文件。
1、使用 pwd 命令确认当前所在路径；
2、执行 ls -l webman 检查是否存在该文件且具备可执行权限；
3、若输出显示 No such file or directory，说明该文件被误删或未由 Composer 正确生成；
4、进入项目根目录后，重新执行 php webman start。
二、检查 webman 脚本文件权限与内容完整性
即使文件存在，若权限不足或内容损坏，PHP 也无法解析执行。该脚本本质是 PHP 文件，首行应为 #!/usr/bin/env php，且需有执行权限。
1、执行 head -n 1 webman，确认首行为 #!/usr/bin/env php；
2、执行 file webman，检查是否为 ASCII 文本文件；
3、若权限不足，运行 chmod +x webman 赋予执行权；
4、若内容为空或乱码，从官方仓库重新下载标准 webman 脚本并覆盖。
三、验证 PHP 解释器能否正确加载 webman 脚本
部分系统因 shebang 解析失败或 PHP 环境变量异常，导致直接执行 ./webman 失败，但显式调用 php webman 应始终可用——若仍报错，则问题出在脚本入口逻辑或 PHP 运行环境。
1、执行 php -f webman -- help，绕过 shebang 直接强制解析；
2、若提示 Parse error 或 syntax error，说明 webman 文件本身存在语法破坏；
3、若提示 Class 'Webman\Console' not found，表明 autoloader 未初始化，可能 vendor/autoload.php 未被引入或 composer install 未完成；
4、进入项目根目录后，执行 composer install --no-dev 确保依赖完整。
四、检查当前目录是否为 Webman 项目根目录
Webman 的 webman 脚本依赖于同级的 start.php 和 config/ 目录结构。若在子目录（如 app/ 或 public/）中执行，脚本将因路径解析失败而中断。
1、执行 ls -F | grep '/\|start\.php'，确认同时存在 start.php 和 config/ 目录；
2、若缺失 start.php，说明项目未正确初始化，需重新运行 composer create-project webman/webman myapp；
3、若存在但路径层级错误（例如 myapp/public/webman），请切换至 myapp/ 目录再执行；
4、禁止将 webman 脚本复制到其他目录单独使用，其功能强耦合于项目结构。
五、排除 Windows 系统下 CRLF 换行符导致的解析失败
在 Windows 上通过 Git Bash 或 WSL 编辑、克隆项目时，若 webman 脚本被写入 CRLF（\r\n）换行符，PHP 解析器可能在 shebang 行末尾误读 \r 字符，导致“bad interpreter”错误。
1、在 Linux/macOS 终端中执行 cat -A webman | head -n 1，观察是否末尾含 $ 后紧跟 ^M；
2、若存在 ^M，说明为 DOS 格式，执行 dos2unix webman 转换；
3、若无 dos2unix 命令，可用 sed -i 's/\r$//' webman 删除行尾 \r；
4、保存后再次执行 php webman start 验证是否恢复正常。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
