本篇文章介绍了如何在专业版 Pycharm 中配置远程服务器上的Python解释器,测试的 Pycharm 版本为2023.2.
一、配置远程解释器
- 首先,打开或新建一个本地的项目,在 pycharm 的右下角可以看到显示
No Interpreter
,说明此时项目尚未配置 python 解释器。点击No interpreter > Interpreter Settings
,开始设置 python 解释器。
- 点击右边的
Add Interpreter > On SSH
添加远程 python 解释器。
- 输入服务器的地址和用户名,然后点击 Next,输入密码,点击 Next。
如果你以前连接过服务器,则可以直接点击 Existing
,选择配置好的方案,点击 Next
。
等待 Pycharm 与服务器建立连接,点击 Next。
- 接下来是最重要的一步。远程虚拟环境与系统环境的配置类似,这里介绍系统环境的配置。点击
System Interpreter
,Interpreter
栏是远程服务器上的 python 解释器的路径,Sync folders
是本地项目文件与远程服务器上的文件的映射路径,也就是你想把远程服务器上的文件下载到本地的哪个路径,或者你想把你本地的文件上传到远程服务器的哪个路径下。Automatically upload project files to the server
是自动将本地文件上传到远程服务器进行同步,根据个人需要自行选择是否勾选(建议取消勾选,这样还能用远程服务器上的文件当个备份)。
-
点击
Interpreter
右边的...
选择远程服务器上的 python 解释器。Anaconda 的 base 环境的 python 解释器的路径为anaconda/bin/python
,其他环境的路径为anaconda/envs/[环境名称]/bin/python
。选择完毕后,点击 OK。
-
点击
System Interpreter
右边的文件夹标识,进行映射路径的配置。Local Path
默认是当前本地项目的路径,一般不用修改。Remote Path
是远程服务器上存放文件的路径,需要调整为你想存放的路径。点击表格框,点击右侧的文件夹标识,选择相应的存放路径,点击OK > Create
即创建解释器。
- 返回
Python Interpreter
界面,可以看到显示出了远程解释器对应安装的包有哪些,点击 OK 即可完成对远程解释器的配置。
- 点击
Python Interpreter
栏,可以看到已经配置的解释器。
点击Show All
可以查看所有配置的解释器。选中某个解释器后,点击上方的铅笔符号
可以对解释器进行重命名,点击+
或-
可以新增配置或删除配置。
二、在 Pycharm 中浏览和下载远程服务器上的文件
配置好解释器后,你可以在本地创建代码脚本然后利用远程解释器执行,但是如果代码在远程服务器上又该怎么办呢?当然,你可以浏览器访问网页端、下载文件然后复制粘贴到本地项目中,但是这样太过麻烦。接下来我将介绍如何在 Pycharm 中直接浏览和下载远程服务器上的文件。
- Pycharm 主界面左上角选中
Tools > Deployment > Configuration
.
- 在弹出的
Deployment
界面,点击左上角+
> SFTP,为服务起一个名字,然后点击 OK。
- 在
SSH configuration
中选中刚刚配置好的连接,然后点击Test Connection
看看是否能连上服务器,如果提示Successfully connected to XXXX
则说明没问题,如果报错则需要重新配置 SSH (点击右侧...
进行配置)。其他的默认即可。
- 点击上方
Mappings
选项卡,和之前配置远程服务器映射路径一样,配置Deployment path
,其他的保持默认即可。点击 OK 完成配置。
- Pycharm 主界面左上角选中
Tools > Deployment > Browse Remote Host
打开服务器的浏览窗口。若显示Nothing to show
,重启 Pycharm 再打开即可。
- 在浏览窗口选择文件,然后右键,选择
Download from here
即可将远程服务器的文件下载到本地。
三、Pycharm 上传本地文件到服务器
在配置好远程服务器后,Pycharm 中可以直接将本地文件上传至服务器。
右键想要上传的文件,选中 Deployment > Upload to XXXX
,即可上传文件至服务器(覆盖)。
四、Pycharm 中配置远程 Jupyter Notebook
虽然已经配置好了远程的 python 解释器,运行 .py
文件没问题,但是运行 jupyter notebook 时需要进行额外的配置。
- 打开或新建一个 jupyter notebook 文件,点击右上角的
Manage Jupyter Server > Configure Jupyter Server
.
- 点击
Configured Server
选项卡,填入服务器地址,点击 OK。
- 然后就可以运行 jupyter notebook 啦!如果要切换 Kernel,点服务器旁边的
O
就可以切换。
对于早一些版本的 Pycharm 在配置远程 Jupyter Notebook 时报错Jupyter Server URL is malformed
,可以参考我的这篇文章进行解决。