VS Code Remote-SSH 远程连接服务器开发指南通过 VS Code 的 Remote - SSH 扩展像操作本地项目一样远程编辑和开发服务器代码。一、为什么需要 Remote-SSH之前的方式方式缺点用 WinSCP 上传下载文件每次修改都要上传麻烦在服务器上直接 vim 编辑不习惯命令行编辑器本地开发完再部署环境不一致容易出问题Remote-SSH 的好处在 VS Code 里直接打开服务器上的文件夹像本地项目一样编辑代码实时保存到服务器直接使用服务器上的 Python 环境.venv运行和调试内置终端自动连接服务器不用另开 SSH 窗口二、操作步骤2.1 安装 Remote - SSH 扩展步骤操作1打开 VS Code2点击左侧扩展图标或按Ctrl Shift X3搜索Remote - SSH4点击安装微软官方出品图标是绿色 符号2.2 配置 SSH 连接第 1 步打开命令面板按Ctrl Shift P输入并选择Remote-SSH: Open SSH Configuration File...第 2 步选择配置文件选择第一个路径通常是C:\Users\你的用户名\.ssh\config如果文件不存在会提示创建。第 3 步添加服务器配置在打开的配置文件中粘贴以下内容Host 测试服务器 HostName deepseek.test.com Port 10101 User yyq保存文件Ctrl S。配置说明项值含义Host测试服务器连接名称可自定义HostNamedeepseek.test.com服务器地址Port10101SSH 端口Useryyq登录用户名2.3 连接服务器第 1 步连接按F1或Ctrl Shift P输入Remote-SSH: Connect to Host...选择测试服务器在弹出的密码框中输入yourpassword第 2 步等待连接成功VS Code 会在右下角显示 “正在连接…”第一次连接会稍慢需要安装 VS Code Server 到服务器之后秒连。连接成功后左下角会显示SSH: 测试服务器2.4 打开项目文件夹点击 VS Code 左侧的资源管理器图标或按Ctrl Shift E点击“打开文件夹”输入路径/home/test/test-platform-backend点击确定现在就可以像本地项目一样浏览、编辑代码了2.5 使用终端按Ctrl 反引号打开 VS Code 内置终端会自动连接到服务器可以直接运行cd/home/test/test-platform-backendsource.venv/bin/activate ./manage.sh status⚠️ 三、重要不要和已有服务冲突3.1 为什么会冲突服务器上已经有一个通过systemd启动的 test-platform 服务它占用了6101 端口。如果你在 VS Code 终端里直接运行python main.py会报错ERROR: [Errno 98] Address already in use因为一个端口只能被一个进程占用新的进程起不来。3.2 那 VS Code 远程开发该怎么用核心回答用 VS Code 打开项目来查看和编辑代码改完后重启 systemd 服务生效。具体分几种场景场景一只改代码不手动运行推荐用 VS Code 编辑代码改完保存到服务器然后重启 systemd 服务让改动生效# 在 VS Code 终端执行需要 sudo 密码yourpasswordsudosystemctl restart test-platformsudosystemctl restart test-platform-worker场景二想本地调试运行需要手动跑第一步先停掉已运行的 systemd 服务释放 6101 端口sudosystemctl stop test-platformsudosystemctl stop test-platform-worker第二步再手动运行前台模式方便看日志和调试cd/home/test/test-platform-backendsource.venv/bin/activate python main.py此时终端会卡住显示运行日志按Ctrl C停止。第三步调试完恢复 systemd 服务sudosystemctl start test-platformsudosystemctl start test-platform-worker场景三只查看日志不用运行tail-f/home/yyq/test-platform-backend/app.log# 实时看 API 日志tail-f/home/yyq/test-platform-backend/worker.log# 实时看 Worker 日志3.3 一句话总结你想做什么怎么做 查看/编辑代码VS Code 直接打开不要手动运行 改完上线保存后sudo systemctl restart test-platform 本地调试跑先停 systemd再python main.py用完恢复 只看日志tail -f app.log或tail -f worker.log四、注意事项4.1 密码输入每次连接都需要输入密码。如果不想每次都输可以配置 SSH 密钥登录后续优化。4.2 端口转发如果需要在本地浏览器访问服务器服务如http://127.0.0.1:6101/docs可以配置 VS Code 的端口转发目前发现是自动配置端口转发不需要手动配置了在 VS Code 底部状态栏找到“端口”PORTS标签点击“转发端口”输入端口号6101访问http://127.0.0.1:6101/docs4.3 断开连接关闭 VS Code 窗口即断开或按F1→Remote-SSH: Close Remote Connection...4.4 常用操作快捷键快捷键操作Ctrl Shift P打开命令面板Ctrl 打开/关闭终端Ctrl Shift E打开资源管理器Ctrl S保存文件F1打开命令面板同上五、进阶VS Code 端口转发访问服务连接成功后还可以用 VS Code 自带的端口转发功能把服务器 6101 端口转发到本地在 VS Code 底部找到“端口”PORTS面板点击“转发端口”输入6101浏览器访问http://127.0.0.1:6101/health这样就不用另开一个 SSH 隧道窗口了一切都在 VS Code 里完成。
