Ubuntu下phpstorm如何配置SMTP邮件服务

在日常开发中，邮件通知是一个相当实用的功能——比如保存文件时自动触发通知，或者集成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）来管理敏感信息，建议用起来。