PhpStorm Terminal 默认使用系统shell但需与项目、环境、PHP配置对齐：确保项目正确打开并识别，检查Shell path和启动目录；PHP命令依赖shell的PATH而非IDE配置，需手动配置环境变量；中文乱码需统一UTF-8编码，Windows推荐PowerShell；自定义脚本用Run Configuration更可靠。
PhpStorm 内置 Terminal 不是摆设，它默认就用你系统当前 shell（macOS/Linux 是 zsh 或 bash，Windows 是 cmd.exe 或 PowerShell），但多数人一打开就卡在路径不对、命令找不到、中文乱码或脚本不执行——根本原因不是 Terminal 本身有问题，而是它和项目、shell 环境、PHP 配置没对齐。
Terminal 启动后当前路径为什么不是你的项目根目录？
PhpStorm 默认把 Terminal 工作目录设为「项目根目录」，但前提是：你用 File > Open 打开的是整个项目文件夹，而不是单个文件；且没有手动改过设置。如果打开 Terminal 后显示的是家目录或空路径，大概率是项目未被正确识别。
- 检查左上角菜单栏是否显示项目名（如
my-laravel-app），没显示说明 PhpStorm 没加载项目结构 - 右键项目根文件夹 →
Reload project，强制刷新索引 - 进
Settings > Tools > Terminal，确认Shell path没被误改成/bin/sh这类受限 shell - Windows 用户若看到
C:\Users\XXX而非项目路径，去Settings > Tools > Terminal把Shell path改成cmd.exe或powershell.exe，并勾选Start directory下的Project root
运行 PHP 脚本时提示 Command not found: php 或版本错乱
Terminal 能否调用 php 命令，完全取决于它启动时读取的 shell 环境变量，和 PhpStorm 自己配的 PHP 解释器无关。你在系统终端能跑 php -v，不代表 PhpStorm 的 Terminal 就能。
- 先在系统终端执行
which php（macOS/Linux）或where php（Windows），记下完整路径，比如/usr/local/bin/php或C:\xampp\php\php.exe - 在 PhpStorm Terminal 里直接运行该绝对路径，如
/usr/local/bin/php artisan migrate—— 能跑就证明 PHP 本身可用 - 想让
php命令全局生效：编辑 shell 配置文件（~/.zshrc或~/.bash_profile），加一行export PATH="/usr/local/bin:$PATH"，然后重启 PhpStorm（仅重载 Terminal 不生效） - Mac M1/M2 用户常见坑：
brew install php装的 PHP 在/opt/homebrew/bin/php，但默认 shell 没加载 homebrew 的 PATH，必须手动补全
执行含中文参数或输出的 PHP 脚本出现乱码
乱码本质是 Terminal 编码和 PHP 输出编码不一致。PhpStorm Terminal 默认编码是 UTF-8，但 Windows 的 cmd.exe 默认是 GBK，PHP 脚本若用 echo "你好" 就会崩。
立即学习“PHP免费学习笔记（深入）”；
- Windows 用户优先切到
PowerShell：进Settings > Tools > Terminal，把Shell path改成powershell.exe，它原生支持 UTF-8 - 坚持用
cmd.exe的话，在 Terminal 里先执行chcp 65001（切换为 UTF-8 代码页），再运行脚本 - PHP 脚本内加
mb_internal_encoding('UTF-8');和header('Content-Type: text/html; charset=utf-8');（仅限 Web 场景）不能解决 CLI 乱码，CLI 下无效 - macOS/Linux 一般无此问题，但如果终端 locale 是
en_US.UTF-8而 PHP 设置了setlocale(LC_ALL, 'zh_CN.GBK')，也会触发乱码，删掉或统一成zh_CN.UTF-8
想一键运行自定义脚本（如部署、数据导入）但不想每次都敲长命令
别在 Terminal 里反复粘贴命令，用 PhpStorm 的「Run Configuration」绑定脚本更稳，还能带参数、设工作目录、捕获错误。
- 点右上角
Add Configuration > + > Shell Script -
Script path填绝对路径，如$ProjectFileDir$/scripts/deploy.sh（$ProjectFileDir$是 PhpStorm 变量，自动替换成项目根） -
Working directory设为$ProjectFileDir$，确保脚本里的相对路径正常解析 - 需要传参？在
Script parameters栏填，如--env=prod --force - 执行前想确认？勾选
Confirm before running；想看实时输出？确保Show console when a message is printed已启用
最常被忽略的一点：Terminal 里的环境变量（如 PATH、COMPOSER_HOME）不会自动继承 PhpStorm 的「PHP @ Language & Frameworks > PHP > CLI Interpreter」配置，它们是两套体系。调试时发现 Composer 命令失效、Laravel Mix 找不到 Node，往往是因为 Terminal 没加载 nvm 或 pnpm 的初始化脚本——得手动在 shell 配置里补全，而不是指望 IDE 替你搞定。
