PhpStorm 2021怎么配置服务器？中文乱码如何解决？

最近换了新电脑，装上了 JetBrains PhpStorm 2021最新版，本来以为跟老版本差不多，结果配置服务器的时候折腾了我一整天。尤其是那个中文乱码，简直让人抓狂。今天抽空整理一下我的踩坑经历，顺便把完整的配置步骤分享出来，希望刚用 PhpStorm 2021 的朋友少走弯路。

JetBrains PhpStorm 2025中文激活版 v2025.3.4绿色版

类型：开发编程大小：1G语言：中文时间：8-27评分：10.0

先说下我的环境：Windows 10 系统，PhpStorm 2021.3 版本，服务器是阿里云的 Linux 主机，用的宝塔面板。如果你也是类似环境，那这篇内容应该挺适合你。

第一步：服务器连接配置，别急着写代码

打开 PhpStorm 2021，点右上角的文件夹图标，找到 Settings，或者直接用快捷键 Ctrl+Alt+S。在左侧菜单里找 Build, Execution, Deployment，点开 Deployment，这里就是配置服务器的地方。

点右上角的 + 号，命名一个连接，比如就叫 my_server。Type 选 SFTP，这是最常用的方式。接着填 Host 地址，就是你的服务器 IP 或者域名。端口默认 22，不用改。User name 填 root，Password 填你服务器的密码。填完之后先别急着重试，把下面那个 Root path 改成你的网站根目录，一般宝塔默认是 /www/wwwroot/你的域名。

然后点 Test Connection，如果提示 Successfully connected，说明网络和账号都没问题。这里有个小坑，很多人把 Web path 也填了，其实这个可以留空，或者跟 Root path 一样就行。我一开始填错了，导致后面上传文件找不到位置。

接着点 Mappings 选项卡，Local path 选你本地的项目文件夹。Web path 填 /，这样上传的时候路径就是根目录。Deployment path 一般留空，除非你有特殊目录结构。配置完点 OK 保存。

第二步：上传代码和自动同步设置

配置好服务器之后，怎么把代码传上去？很简单，选中你的项目文件，右键选择 Deployment，然后点 Upload to my_server。第一次上传会比较慢，因为要把整个项目传过去。如果只改了单个文件，可以按 Ctrl+Shift+X 快捷键，直接同步当前文件，非常方便。

我还开了自动同步，这样每次保存文件，PhpStorm 2021 会自动帮我上传到服务器，省事很多。设置路径在 Settings -> Deployment -> Options，勾选 Upload changed files automatically to the default server，然后选择 On explicit save action。这样每次 Ctrl+S 保存，代码就自动同步过去了。

不过要注意，自动同步有时候会卡住，尤其是网络不好的时候。我后来干脆用快捷键手动上传，反而更稳定。

第三步：中文乱码问题排查，别急着重装

配置好服务器，代码也传上去了，但打开网页一看，满屏乱码，全是锟斤拷这种。别慌，这个问题很常见，跟 PhpStorm 2021 本身关系不大，多半是编码设置不对。

首先检查文件编码。在 PhpStorm 2021 右下角有个小图标，显示当前文件的编码格式，默认是 UTF-8。如果你的文件是 GBK 编码，这里会显示 GBK，点击它，选择 Convert to UTF-8，转换一下。注意要选 Convert，不是 Reload，否则文件内容会变。

然后检查全局编码设置：Settings -> Editor -> File Encodings，把 Global Encoding、Project Encoding、Properties Files 都改成 UTF-8。下面那个 Default encoding for properties files 也改成 UTF-8，这样新建文件就不会乱码了。

还有一个容易忽略的地方，就是数据库连接。如果你用了数据库，连接字符串里的编码参数也要加上。比如 MySQL 连接，在 URL 后面加 ?useUnicode=true&characterEncoding=UTF-8，这样查询结果就不会乱码了。

第四步：服务器端编码也要统一

很多朋友只改本地，忘了服务器端。如果你的服务器是 Linux，可能需要检查一下默认字符集。用宝塔的话，打开终端，输入 locale，看看 LANG 是不是 zh_CN.UTF-8 或者 en_US.UTF-8。如果不是，执行 export LANG=en_US.UTF-8，然后重启一下 PHP 服务。

另外，如果用了 Nginx，检查一下配置文件里的 charset 设置。在 server 块里加上 charset utf-8;，然后 reload 一下 Nginx。这一步很容易漏掉，我上次就是被这个坑了。

还有，如果你的代码里用了 file_get_contents 或者 file_put_contents，这些函数默认用的编码可能不是 UTF-8，最好显式加上。比如 file_put_contents($file, $data, LOCK_EX) 改成 file_put_contents($file, $data, LOCK_EX | FILE_TEXT)，然后在文件开头加上 header('Content-Type: text/html; charset=utf-8');。

第五步：几个常见小问题和我的解决经验

1. 上传后文件权限不对，导致网站打不开。在宝塔里把网站目录权限改成 755，文件改成 644，一般就能解决。

2. 连接超时，尤其是用了代理或者 VPN 的时候。检查一下 PhpStorm 2021 的网络设置，Settings -> System Settings -> HTTP Proxy，改成 No proxy 或者手动填代理。

3. 中文乱码顽固，转换编码后还是乱。这时候看看是不是数据库表结构的问题。用 phpMyAdmin 打开表，把字段的排序规则改成 utf8_general_ci，重新导入数据。

4. 如果你用的是 Mac 系统，可能还要在终端里执行 sudo locale-gen zh_CN.UTF-8，否则终端显示中文也会乱。

这些坑我基本都踩过，折腾了一天才搞定。希望我的经验能帮到大家，如果还有问题，欢迎留言交流。

FAQ 常见问题解答

Q1：PhpStorm 2021 配置服务器时，Test Connection 一直失败怎么办？

先检查服务器 IP 和端口是否开放，用 ping 和 telnet 测试一下。如果用的是云服务器，需要去安全组放行 22 端口。还有可能是用户名密码错误，或者 SSH 登录方式不支持，试试改用密钥登录。

Q2：上传代码后，网页显示中文乱码，但本地预览正常，怎么排查？

首先确认服务器端的文件编码是 UTF-8，然后用浏览器开发者工具看响应头，有没有 charset=utf-8。如果没有，在代码里加上 header，或者修改 Nginx 配置。还要检查数据库连接字符串，以及 PHP 文件本身是否被 BOM 头干扰。

Q3：PhpStorm 2021 自动同步会不会冲突？

如果多人协作，自动同步可能会覆盖别人的修改。建议关闭自动同步，改用手动上传。或者开启版本控制，用 Git 来管理，这样更安全。