• ✅ 前提条件（Checklist）

条件	是否满足
✅ PyCharm 安装了 专业版 (Professional)	☐
✅ 拥有远程 Linux 服务器 的 IP、用户名、密码	☐
✅ 服务器已开启 SSH 服务（默认端口 22）	☐
✅ 已连接 学校 VPN（若服务器在内网）	☐

• PyCharm版本：此功能仅限PyCharm专业版（Professional Edition），社区版（Community）不支持。（官网最新版本已经将两版融合）

学生认证申请免费使用专业版教程详见博客：

https://blog.csdn.net/qq_46474804/article/details/136317486?fromshare=blogdetail&sharetype=blogdetail&sharerId=136317486&sharerefer=PC&sharesource=qq_63636940&sharefrom=from_linkhttps://blog.csdn.net/qq_46474804/article/details/136317486?fromshare=blogdetail&sharetype=blogdetail&sharerId=136317486&sharerefer=PC&sharesource=qq_63636940&sharefrom=from_link

🚀 第一步：配置 SFTP 连接（文件同步）

目的：建立本地项目文件夹 ↔ 服务器项目文件夹的映射，实现代码自动上传/下载。

---

1. 打开部署配置

👉 菜单路径：
Tools (工具) → Deployment (部署) → Configuration... (配置...)

---

2. 新建 SFTP 连接

• 点击左上角 + → 选择 SFTP

---

3. 填写连接信息

📌 Connection 选项卡

字段	说明	示例
Name	给连接起个名字	实验室服务器
SFTP host	点击右侧 ... 配置 SSH	👉 点击进入

🔧 SSH Connection 弹窗

字段	说明	示例
Host	服务器 IP 地址	192.168.1.100
Port	SSH 端口	22（默认）
Username	登录用户名	yourname
Authentication type	认证方式	Password
Password	登录密码	********

✅ 填完后点击 Test Connection 测试是否能连上！

 

4. 设置文件路径映射（关键！）

👉 切换到 Mappings 选项卡

字段	操作	示例
Local path	本地项目文件夹	/Users/you/Projects/my_project
Deployment path on server	服务器上的项目路径	/home/yourname/my_project

💡 小贴士：建议本地和服务器都创建同名文件夹，避免路径混乱！

✅ 勾选：Upload changed files automatically to the default server
并选择 On explicit save action（Ctrl+S 保存时自动上传）

5. 保存配置

点击 OK 完成 SFTP 配置 ✅

---

 配置过程中有问题详见下面两篇图文教程：https://blog.csdn.net/weixin_43082343/article/details/119703433?fromshare=blogdetail&sharetype=blogdetail&sharerId=119703433&sharerefer=PC&sharesource=qq_63636940&sharefrom=from_linkhttps://blog.csdn.net/weixin_43082343/article/details/119703433?fromshare=blogdetail&sharetype=blogdetail&sharerId=119703433&sharerefer=PC&sharesource=qq_63636940&sharefrom=from_link

https://lxltx.blog.csdn.net/article/details/136784095?fromshare=blogdetail&sharetype=blogdetail&sharerId=136784095&sharerefer=PC&sharesource=qq_63636940&sharefrom=from_linkhttps://lxltx.blog.csdn.net/article/details/136784095?fromshare=blogdetail&sharetype=blogdetail&sharerId=136784095&sharerefer=PC&sharesource=qq_63636940&sharefrom=from_link

🧠 第二步：配置远程 Python 解释器（核心！）

目的：让 PyCharm 使用服务器上的 Python 环境（如 Conda、虚拟环境）来运行代码。

---

1. 打开解释器设置

👉 菜单路径：
File → Settings → Project: [项目名] → Python Interpreter

---

2. 添加远程解释器

• 点击右上角 ⚙ → Add...

---

3. 选择 SSH 解释器类型

• 左侧选择：SSH Interpreter
• 右侧选择：Existing server configuration
• 从下拉框中选择你刚创建的连接（如“实验室服务器”）
• 点击 Next

---

4. 配置远程解释器路径（最关键的一步！）

❓ 如何找到 Python 路径？

在服务器终端中执行：

# 如果使用 Conda
conda activate your_env_name
python -c "import sys; print(sys.executable)"

输出示例：

/home/yourname/anaconda3/envs/pytorch/bin/python

---

📌 在 PyCharm 中填写：

字段	说明
Interpreter	粘贴上面查到的完整路径
Sync folders	点击 ...，确认本地和远程路径正确

---

 

5. 完成配置

点击 Finish
PyCharm 开始连接服务器并加载包列表（可能需要几十秒）

✅ 成功后，你会看到远程环境的包列表（如 torch, numpy 等）

---

🎉 第三步：验证与使用

---

✅ 验证配置是否成功

1. 查看解释器路径是否为 ssh://...
2. 包列表是否显示服务器上的包
3. 在代码中 import torch，看是否报错

---

🔧 常用功能

功能	菜单路径	说明
启动远程终端	Tools → Start SSH Session...	直接打开服务器命令行
手动上传文件	右键文件 → Upload to...	手动同步单个文件
下载服务器文件	右键服务器文件 → Download from...	把服务器文件拉回本地

---

🚀 运行你的代码！

现在，点击 ▶️ Run 按钮，你的代码就会在远程服务器上运行，并使用服务器的 GPU 资源！

 

💡 常见问题

问题	解决方案
连接超时	检查 IP、端口、VPN、防火墙
密码错误	重新输入，或尝试密钥登录
包找不到	确认 Interpreter 路径是否正确，是否激活了正确的 Conda 环境
代码未同步	检查 Mappings 路径是否匹配，或手动上传
自动上传失效	在 Deployment → Options 中检查设置

 

🔧 补充功能：远程终端与文件浏览（增强你的远程开发体验）

在成功配置了 SFTP 连接和远程 Python 解释器后，PyCharm 还提供了两个非常实用的功能，让你能像操作本地项目一样管理远程服务器。以下是详细补充：

---

📌 功能一：启动远程 SSH 终端（直接控制服务器）

用途：无需打开额外的终端软件（如 Xshell、Terminal），直接在 PyCharm 内部打开一个连接到服务器的命令行终端，用于：

• 激活 Conda/虚拟环境
• 安装包（pip install, conda install）
• 查看文件、运行 shell 命令、监控 GPU 使用情况（nvidia-smi）

---

如何使用：

👉 菜单路径：
Tools (工具) → Start SSH Session... (启动 SSH 会话...)

 

• 点击后，会弹出一个选择框，列出你已配置的所有服务器连接。
• 选择你要连接的服务器（如“实验室服务器”）。
• 回车确认。

✅ 效果：PyCharm 底部会打开一个新的 Terminal 标签页，命令行前缀会显示为 [your_username@server_ip]，表示你已登录到远程服务器。

# 示例：在 PyCharm 内置终端中执行
$ nvidia-smi                    # 查看 GPU 状态
$ conda activate pytorch_env    # 激活环境
$ pip install wandb             # 安装新包

💡 优势：所有操作都在 PyCharm 内完成，无需切换窗口，开发效率大大提升！

---

📌 功能二：浏览远程主机文件（可视化查看服务器文件）

用途：在 PyCharm 的项目视图中，直接查看、下载、上传服务器上的文件，就像浏览本地文件夹一样。

---

如何使用：

👉 菜单路径：
Tools (工具) → Deployment (部署) → Browse Remote Host (浏览远程主机)

 

• 点击后，PyCharm 右侧会弹出一个新的面板，标题为 Remote Host。
• 里面显示了你服务器上 Deployment path on server 目录下的所有文件和文件夹。

---

你能做什么？

操作	方法
查看文件	双击文件即可在 PyCharm 中打开查看（只读）
下载文件	右键文件 → Download from here → 将服务器文件下载到本地
上传文件	右键文件夹 → Upload to here → 将本地文件上传到服务器
刷新	右键任意位置 → Reload from Disk
新建文件夹	右键 → New → Directory

 

⚠️ 注意：通过 Browse Remote Host 打开的文件是只读的。如需编辑，请确保文件已映射到本地项目路径，并在本地编辑。启用“自动上传”后，保存即同步。

---

🎯 实际工作流示例

1. 写代码：在本地 my_project/train.py 中编写训练脚本。
2. 看文件：通过 Browse Remote Host 确认数据集 dataset.zip 已上传到服务器。
3. 开终端：通过 Start SSH Session 登录服务器，解压数据集：

   unzip dataset.zip

4. 运行代码：在 PyCharm 中点击 ▶️ Run，代码在服务器上执行，输出显示在本地控制台。
5. 查结果：训练完成后，通过 Browse Remote Host 找到生成的日志或模型文件，右键下载到本地。

---

✅ 总结：PyCharm 远程开发三件套

功能	菜单路径	作用
文件同步	Tools → Deployment → Configuration	自动同步代码
远程终端	Tools → Start SSH Session...	控制服务器命令行
文件浏览	Tools → Deployment → Browse Remote Host	可视化管理服务器文件

 

 

💬 有问题？欢迎在评论区留言！