PhpStorm内置Terminal默认不加载shell配置导致命令报错；需将Shell path设为绝对路径加-l参数（如/bin/zsh -l），关闭并重开标签页，再执行echo $PATH验证PATH是否包含PHP/Composer路径。
PhpStorm 内置 Terminal 能直接用，但默认配置大概率不 work —— 不是功能坏了，而是 shell 环境没加载你的 PATH 和配置文件，导致 php、composer、artisan 全部报 command not found。
Terminal 打不开或一启动就报错
根本原因通常是 Shell path 指向了无效路径，或 shell 启动时因配置错误崩溃。比如 macOS 上填了 zsh 但实际路径是 /bin/zsh；Windows 用户填了 git-bash 却没加引号和正斜杠；Linux 用户用了自定义 zsh 插件，初始化脚本报错阻塞终端启动。
- 进
Settings → Tools → Terminal，Shell path 必须填绝对路径：/bin/zsh（macOS/Linux）、cmd.exe或powershell.exe（Windows）、"C:/Program Files/Git/bin/bash.exe"（Git Bash） - 如果终端窗口空白或闪退，先取消勾选
Shell integration，排除干扰 - macOS 上用了 Oh My Zsh 或切换过默认 shell，临时改回
/bin/zsh测试是否能启动
终端里 php/composer/artisan 找不到命令
这不是 PhpStorm 的 bug，而是它默认启动的是 non-login shell，不读 ~/.zshrc、~/.bash_profile，PATH 里自然没有你 brew 或 scoop 装的 PHP 和 Composer。
- 把 Shell path 改成带
-l参数的登录模式：/bin/zsh -l（macOS/Linux）、cmd.exe /k（Windows） - 改完必须关闭所有 Terminal 标签页，再新建一个——重启 IDE 不生效
- 验证是否成功：在新 Terminal 里执行
echo $PATH，确认输出含/opt/homebrew/bin（Apple Silicon）或/usr/local/bin（Intel/macOS）或你 Composer 的安装路径 - Windows PowerShell 用户还需运行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，否则 Composer 脚本被拦截
怎么快速打开并切到当前文件所在目录
Terminal 默认工作目录是项目根目录，不是你正在编辑的文件所在目录 —— 这点容易误判，尤其在多模块 Laravel 项目里。
立即学习“PHP免费学习笔记（深入）”；
- 右键编辑器标签页 → 选
Open in Terminal，会自动cd到该文件所在目录 - 快捷键
Alt+F12（Windows/Linux）或Option+F12（macOS）可聚焦 Terminal，再按一次切回编辑区，免鼠标 - 想固定在某个目录启动 Terminal？在 Shell path 后加启动命令，例如：
/bin/zsh -l -c "cd /path/to/app && exec zsh"
artisan serve 启动后 localhost:8000 访问不了
不是端口被占，也不是 APP_URL 配错了，而是 PhpStorm 终端默认把 php artisan serve 当作一次性命令处理，服务启动后终端就“认为任务结束”，可能释放端口或杀掉子进程。
- 启动前，在 Terminal 设置里勾选
Allow terminal to stay open when command finishes - 显式指定 host 和 port：
php artisan serve --host=127.0.0.1 --port=8000 - 避免与 Valet/Docker 冲突：确保
APP_URL是http://127.0.0.1:8000，而不是http://myapp.test - 若仍失败，换用 Run Configuration：菜单
Run → Edit Configurations → + → PHP Script，选artisan文件，Arguments 填serve，更稳定
最常被忽略的一点：Terminal 和 PhpStorm 的 PHP 解释器配置是两套独立系统 —— 你在 Settings → PHP → Interpreter 里配得再好，也不会自动注入到 Terminal 的环境变量里。PATH、扩展、甚至 php.ini 路径，都得靠 shell 配置文件自己加载。
