Ubuntu下phpstorm如何配置SMTP邮件服务
在Ubuntu系统中,打开PhpStorm设置,进入Tools菜单下的ActionsonSave选项,勾选Sendemail功能,然后添加SMTP服务器配置,需要填写主机地址、端口号、用户名、应用专用密码以及加密方式(如SSL/TLS),点击测试验证连接,成功后再保存设置。这样每次保存文件时,PhpStorm会自动发送邮件通知。
在日常开发中,邮件通知是一个相当实用的功能——比如保存文件时自动触发通知,或者集成CI/CD的告警。在Ubuntu系统下用PHPStorm配置SMTP服务,其实并不复杂,但几个关键细节需要留意。下面直接进入正题。

1. 登录PHPStorm并进入设置
打开PHPStorm,点击顶部菜单栏的 File(或 Configure)→ Settings(Windows/Linux 下是 File > Settings,macOS 则是 PhpStorm > Preferences),进入全局设置界面。这一步没什么特殊,大家应该都熟。
2. 导航至邮件通知配置
在设置窗口左侧,展开 Tools 选项,点击 Actions on Sa ve(也可以直接搜索“Email Notifications”),找到对应的面板。这个功能默认是隐藏的,别被它“藏得深”吓到,其实就在那。
3. 启用并配置SMTP邮件发送
- 勾选 Send email 选项——开启保存文件时发送邮件的功能;
- 点击右侧的 Configure… 按钮,打开“Email Notifications”详细配置窗口;
- 点击 Add configuration(+),创建新的SMTP配置,然后填写以下关键信息:
- Name:随便取个名字,比如“Gmail SMTP”或“公司邮箱”,方便标识就行;
- SMTP Host:SMTP服务器地址,Gmail 是
smtp.gmail.com,QQ邮箱是smtp.qq.com,企业邮箱替换成你自己的; - SMTP Port:常用
587(TLS加密)或465(SSL加密),具体以服务商要求为准; - SMTP Username:登录用户名,通常是邮箱全地址,比如
yourname@gmail.com; - SMTP Password:登录密码。注意,如果用的是Gmail这类第三方邮箱,很可能需要生成“应用专用密码”,而不是直接用邮箱密码;
- Authentication:认证方式,一般选“Login”或“PLAIN”;
- Encryption:勾选“Use SSL/TLS”。端口是
465时选“SSL”,是587时选“TLS”。
4. 测试SMTP配置
点击 Test Configuration 按钮,PHPStorm 会尝试连接SMTP服务器并发送测试邮件。如果一切顺利,会弹出“SMTP server is reachable”的提示。要是失败了,别急着怀疑人生——从下面几个方向排查一下:
- SMTP服务器地址、端口是否写对了;
- 用户名和密码是否有误(尤其是第三方邮箱的应用密码);
- 防火墙是否允许对应端口的出站流量?比如 Ubuntu 下可以用
ufw allow 587/tcp放行; - 第三方邮箱的SMTP服务是否已开启?Gmail 需要在“设置→转发和POP/IMAP”中打开IMAP/SMTP权限。
5. 保存配置并验证
点击 OK 保存SMTP配置,再点 Apply 应用设置。之后每次在PHPStorm中保存文件(或触发“Actions on Sa ve”中的其他操作),系统就会通过这个SMTP配置自动发送邮件通知。建议随手试一下,确认通知能正常收到。
几点注意事项:
- 如果使用Gmail、QQ等第三方邮箱,务必先开启SMTP服务并生成授权密码,直接用邮箱密码大概率会失败;
- 企业用户需要联系管理员获取SMTP服务器地址、端口和认证信息,别自己瞎猜;
- 安全方面,尽量不要在配置里写明文密码——PHPStorm支持通过环境变量或加密存储(比如
~/.phpstorm.meta.php)来管理敏感信息,建议用起来。


































