一、概述

1. 案例介绍

华为开发者空间是华为云为全球开发者打造的专属云上成长空间，空间深度整合了昇腾AI、鸿蒙、鲲鹏等华为根技术。2025HDC大会上，华为开发者空间迎来全面升级，新增AI原生应用引擎、AI Notebook、云开发环境、FunctionGraph云函数、Astro低代码等核心能力，并在算力、模型、平台、应用层实现全方位优化，助力开发者高效完成从编码到调测的全流程，打造智能AI应用开发新体验。

华为开发者空间 - 云开发环境提供“云IDE解决方案”，为开发者构建一个以开发者体验为核心、开放集成的云端开发平台生态。支持主流IDE、提供多样化入口、开放API/SDK，并与开发者深度合作持续优化，致力于让云端开发环境成为广大开发者的首选、高校愉悦的工作方式。

基于华为开发者空间 - 云开发环境的PyCharm远程编程方案为开发者提供高效云端开发体验。该方案通过PyCharm原生SSH远程解释器功能连接华为云主机，实现本地IDE与云端算力的无缝对接，具有四大核心优势：

• 突破本地设备性能限制，直接调用云端计算资源；
• 保持PyCharm完整开发体验；
• 依托华为云企业级安全防护；
• 统一团队开发环境提升协作效率。

特别适用于三类场景：需要分布式协作的团队开发项目、依赖高性能计算的AI/大数据应用开发，以及需要环境标准化的教学实训场景。该方案既解决了开发环境碎片化问题，又显著降低了团队管理成本，是现代化云端开发的理想选择。

2. 适用对象

• 企业
• 个人开发者
• 高校学生

3. 案例时间

本案例总时长预计60分钟。

4. 案例流程

说明：

1. 登录华为开发者空间，进入开发平台创建云开发环境；
2. 创建隧道，PC端远程连接华为开发者空间 - 云开发环境；
3. 本地Pycharm配置SSH远程解释器；
4. 同步项目代码，实现PyCharm远程编程。

5. 资源总览

最新案例动态，请查阅 《基于华为开发者空间-云开发环境，PyCharm SSH远程开发环境搭建》。小伙伴快来领取华为开发者空间，进入云开发环境桌面版实操吧！

二、配置云开发环境，创建远程连接隧道

1. 创建云开发环境

1.1 创建云开发环境

华为开发者空间-云开发环境平台为开发者提供专属云端开发主机，集成主流IDE工具，支持多端访问和API/SDK调用，打造开箱即用的开发环境。

登录华为开发者空间 - 云开发环境平台，在页面左侧菜单栏选择开发平台 - 计算，点击开发环境，进入开发环境界面。

在开发环境列表下方点击新建开发环境按钮，页面右侧弹出新建开发环境配置界面。

在新建开发环境配置界面依次配置环境名称为PyCharmSSH，开放端口为8081（本案例中使用默认的22端口，此处可在端口范围8080-8089中任意选填），设置默认账号为devenv，最后根据自己情况设置密码。

注：默认账号、密码为后续远程连接时需要用到的虚拟机账号密码，注意保存。

配置完成后，点击新建开发环境配置界面右下角的确认按钮，完成开发环境的创建。创建完成后，在开发环境列表中将新增我们刚才创建的开发环境。

1.2 云开发环境开机

在开发环境列表，PyCharmSSH开发环境的操作栏点击更多，选择开机。开发环境自动进入开机中状态（耗时1~3分钟，此状态无需任何操作），完成开机后状态栏自动变更为运行中。

2. 配置云开发环境

参考案例中心《基于华为开发者空间-云开发环境，部署Jupyter Notebook》“三、PC端环境配置”中的“1. 安装CLI工具包”和“2. 配置AK/SK签名认证”内容，完成华为开发者空间-云开发环境的基础配置。

3. 创建隧道，远程连接华为开发者空间-云开发环境

3.1 创建隧道

打开Windows PowerShell窗口，通过以下命令查看云开发环境instanceId，并创建1234隧道。

hdspace devenv listhdspace devenv start-tunnel --instance-id={instanceId} --local-port={localPort}

从Windows PowerShell窗口输出的日志我们可知，上一步中创建的1234隧道，云开发环境端的对外SSH访问端口为22，本地PC端的访问端口为1234。并且日志中[hds-info]: Listen local port:localPort success则表示隧道监听成功。

3.2 测试SSH远程连接

通过如下指令测试连接。

ssh {默认账号}@127.0.0.1 -p {localPort}

注：此处默认账号为步骤“1. 创建云开发环境”中设置的默认账号；localPort为上一步创建隧道时local-port对应设置的端口号。实际开发中请注意替换。

根据日志提示，输入yes和密码，此处密码为步骤“1.1 创建云开发环境”中设置的密码。

三、PyCharm配置SSH

前提条件：

1. 本案例中使用的为PyCharm 2024.3.2 (Professional Edition)版，PyCharm 2025.1.3.1的PyCharm Pro同样适用于本案例。
2. PC本地已安装Python，本案例中使用的为Python 3.11.4、pip 23.2.1。

1. New Project

在PC本地PyCharm的顶部菜单栏File > New Project，弹出New Project配置对话框。

在New Project配置对话框中左侧新建菜单栏选择Pura Python,在右侧依次配置Location，Interpreter type选择Project venv，并在Python version的下拉三角中选择自己的Python版本（本案例中选用Python 3.11.4）。最后点击Create，完成案例创建。

等待PyCharm自动加载配置文件，加载完成后的状态如下：

2. 配置Configuration

2.1 配置Configuration

在PyCharm的顶部菜单栏打开Tools > Deployment，选择Configuration...，弹出Deployment配置界面。

在Deployment配置界面中，点击左上角的“+”，选择SFTP。

在弹出的Create New Server对话框中输入Sever名称cloudDevEnv，开发者可根据自己的需求设置。点击OK按钮。

2.2 配置Connection

在Deployment配置对话框中，左侧选中cloudDevEnv，在右侧选择Connection页签，点击参数SSH configuration右侧的“...”图标，打开SSH Configurations配置界面。

在SSH Configurations配置界面，点击左上角的“+”，在其右侧设置配置参数：

• Host，设置为默认值127.0.0.1；
• Port，设置为1234（此处port为步骤“3.2 测试SSH远程连接”中设置的{localPort}）；
• Username，设置为devenv（与步骤“1.1 创建云开发环境”中设置的默认账号保持一致）；
• Authentication type，选则Password；
• Password，在步骤“1.1 创建云开发环境”中设置的密码。

最后点击Apply和OK按钮。

返回Deployment配置对话框，SSH configuration选择在SSH Configurations配置界面中配置的devenv@127.0.0.1。

点击Test Connection，弹出Test SFTP Connection对话框，提示Successfully connected to 127.0.0.1,SFTP连接成功。点击OK按钮。

2.3 配置Mappings

在Deployment配置界面中，左侧选中cloudDevEnv，在右侧选择Mappings页签，设置其参数：

• Local path：本地python project对应的工程路径。
• Deployment path：云开发环境对应对的python project路径。

点击右下角的OK按钮，完成Connection和Mappings配置。

2.4 代码同步与浏览远程主机

在PyCharm的顶部菜单栏打开Tools > Deployment,此时我们发现菜单中多了Upload、Download、Sync以及Browse Remote Host等几个新功能：

• Upload to cloudDevEnv：将本地代码上传到服务器。
• Download from cloudDevEnv：将远程服务器的代码拉取到本地。
• Sync with Deployed to cloudDevEnv：同步代码。

我们在PyCharmSS工程的main.py中，增加一段代码。在PyCharm的顶部菜单栏打开Tools > Deployment，选择Upload to cloudDevEnv，控制台输出代码上传成功日志。

在PyCharm的顶部菜单栏打开Tools > Deployment，选择Browse Remote Host，在右侧Remot Host窗口找到对应的工程路径。打开main.py查看，代码上传成功。

同理，在云开发环境端修改、编辑代码，可以使用Download from cloudDevEnv将代码拉取到本地。也可以通过Sync with Deployed to cloudDevEnv对比、同步代码。

2.5 控制台测试连接

在PyCharm的顶部菜单栏打开Tools > Start SSH Session,在弹出的Select Host to Connect对话框中选择devenv@127.0.0.1:1234。

控制台输出上图SSH日志登录信息，控制台连接成功。

这里我们更新下python环境，为下一步配置远程解释器做准备。

sudo yum update -y

sudo yum install python3-devel python3-pip -y

3. 配置远程解释器。

在PyCharm的顶部菜单栏选择File > Settings，打开设置界面。

在Settings设置界面,打开Project {项目名称} > Python Interpreter。在右侧的解释器配置界面，点击右侧的Add Interpreter，选择On SSH。

3.1 配置Connecting to SSH server

在New Target：SSH界面，SSH connection选择Existing，SSH Server在其右侧的下拉三角下选择我们之前创建的devenv@127.0.0.1:1234，点击Next。

注意，在配置完SSH Server后，New Target：SSH界面可能会弹出SSH target is save...字样提示。这是因为在步骤"2.2 配置Connection"中我们勾选了Visible only for this project，此处我们可以点击最后一行提示Move this SSH configuration to IDE settings.中的标蓝字体Move即可。

3.2 配置Introspecting SSH server

等待系统自动完成对SSH服务器进行自检，点击Next。

3.3 配置Project directory and Python runtime configuration

在项目目录和Python运行时配置界面，左侧选中Virtualenv Enviroment。在其右侧：

• Enviroment：选择New，新建环境；
• Location：开发者可以通过右侧文件夹图标，可根据自己的需求在云开发环境中选择Python运行时环境目录；
• Base interpreter：一般系统会自动识别，可以根据实际选择云开发环境中已安装的版本；
• Sync folders：项目目录，可根据自己的需求在云开发环境中选择。

点击Create，等待系统自动完成虚拟环境创建。

注：若系统自动创建虚拟环境时弹出对话框并且提示如下：

/usr/bin/python3: can't open file '/home/devenv/.pycharm_helpers/virtualenv-20.24.5.pyz': [Errno 2] No such file or directory

这是PyCharm用于管理虚拟环境的工具脚本virtualenv-20.24.5.pyz丢失或路径错误。新创建远程解释器，系统没有及时将工具脚本同步到云开发环境端。我们可以多尝试几次，或重启Pycharm，再次尝试创建。

3.4 测试云开发环境端运行

返回Python Interpreter界面，在Python Interpreter参数的右侧下拉选项中选择前面创建的Remote Python 3.9.9(sftp:devenv@127.0.0.1:1234/home/devenv/.virtualenvs/PyCharmSSH/bin/python)，依次点击Apply、OK。

等待远程解释器自动完成配置加载。

点击右上角的运行按钮，控制台输出如下内容。

目录/home/devenv/.virtualenvs/PyCharmSSH/bin/python下的python运行时环境，运行了/home/devenv/PyCharmSSH/main.py文件，输出了如下日志：

欢迎广大开发爱好者体验华为开发者空间-云开发环境，体验不一样的云上编程~~~~~

四、释放资源

在Windows PowerShell窗口Ctrl + C关闭1234隧道，并通过hdspace devenv close命令释放云开发环境资源。

hdspace devenv close --instance-id={instanceId}