ubuntu phpstorm怎么设置

在 Ubuntu 上设置 PHPStorm，通常包括安装、基础配置、PHP 环境、调试（Xdebug）、快捷键/中文等。下面按步骤说明（以 PHPStorm 2023+ 为例，老版本差别不大）。

一、安装 PHPStorm（Ubuntu）

方式 1：官方压缩包（推荐）

1. 官网下载
   https://www.jetbrains.com/phpstorm/download/
2. 解压

tar -xzf PhpStorm-*.tar.gz -C /opt/

3. 运行

/opt/PhpStorm-*/bin/phpstorm.sh

4. （可选）创建桌面快捷方式

/opt/PhpStorm-*/bin/phpstorm.sh
# 启动后：Tools → Create Desktop Entry

方式 2：Snap（简单但不推荐服务器用）

sudo snap install phpstorm --classic

二、首次启动基础设置

1. 激活
   • 正版账号登录
   • 或填 License
2. 导入设置
   • 第一次用选 Do not import
3. 界面语言（中文）
   • Settings → Plugins
   • 搜索 Chinese (Simplified)
   • 安装后重启

三、配置 PHP 解释器（关键）

1. 安装 PHP（如未安装）

sudo apt update
sudo apt install php php-cli
php -v

2. PHPStorm 中配置

File → Settings → PHP

• CLI Interpreter → +
• 选择：
  • Local Path： /usr/bin/php
• 确认 PHP 版本正确

四、配置 Xdebug（调试必备）

1. 安装 Xdebug

sudo apt install php-xdebug

2. 修改 php.ini

查看路径：

php --ini

编辑：

sudo nano /etc/php/8.x/cli/php.ini

末尾添加：

[xdebug]
zend_extension=xdebug
xdebug.mode=debug
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.idekey=PHPSTORM

重启：

sudo systemctl restart apache2
# 或 php-fpm

3. PHPStorm 设置

Settings → PHP → Debug

• Debug Port：9003
• 勾选 Can accept external connections

Settings → PHP → Servers

• 添加本地项目路径映射

五、运行 / 调试项目

1. 打开项目目录
2. 右上角：
   • 点电话图标（Listen for debug）
3. 浏览器装 Xdebug Helper
4. 打断点 → 访问页面即可调试

六、常用优化设置（推荐）

字体

Settings → Editor → Font

推荐：

• JetBrains Mono
• 大小 14–16

保存即格式化

Settings → Tools → Actions on Save

• 勾选 Reformat code

自动补全

Settings → PHP → Code Insight

七、常见问题

❓ PHP 解释器找不到

which php

确认路径填写正确

❓ Xdebug 不生效

• 端口是否 9003
• 是否 Listen 开启
• php -m | grep xdebug

如果你愿意，可以告诉我：

• Ubuntu 版本
• PHP 版本（7.x / 8.x）
• 用 Apache / Nginx / 命令行
• 是否用 Docker

我可以给你更精确的一步步配置。