利用PhpStorm使用Terminal内置终端_命令行操作与脚本执行教程-phpstorm-PHP中文网

phpstorm terminal 默认使用系统shell但需与项目、环境、php配置对齐：确保项目正确打开并识别，检查shell path和启动目录；php命令依赖shell的path而非ide配置，需手动配置环境变量；中文乱码需统一utf-8编码，windows推荐powershell；自定义脚本用run configuration更可靠。

利用phpstorm使用terminal内置终端_命令行操作与脚本执行教程

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 就能。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

先在系统终端执行 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 "你好" 就会崩。

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 替你搞定。