如何配置SimEdit以实现本地运行？

由于SimEdit本地运行的搭建流程较为特殊，本文档整理的操作步骤可作为常规运行方案失效时的参考依据。

前置环境校验 #

• 本地Python版本需保持在3.8~3.10 区间，避免出现依赖兼容问题，可执行python --version命令校验当前版本
• 本地需安装16.x版本的Node.js，可执行node -v命令确认版本匹配

依赖安装步骤 #

• 拉取项目源码到本地后，先进入后端根目录，执行pip install -r requirements.txt安装Python侧依赖
• 若安装过程中出现pyside2相关报错，可单独执行pip install pyside2==5.15.2.1指定版本安装
• 进入前端项目目录，执行npm install安装前端侧依赖，安装超时可临时切换国内npm源操作

服务启动步骤 #

• 先在后端根目录执行python run_server.py启动后端服务，终端输出服务启动成功，监听端口8000即为后端启动正常
• 新开终端窗口进入前端目录，执行npm run dev启动前端服务，打开终端提示的本地前端地址即可正常使用SimEdit

常见异常处理 #

• 前端无法连接后端时，优先检查8000端口是否被其他进程占用：
  • Linux/Mac 环境执行lsof -i:8000查看占用进程
  • Windows 环境执行netstat -ano | findstr 8000查看占用进程
  • 确认端口被占用后结束对应进程，再重新启动后端服务即可
• 出现依赖导入报错时，先核对Python、Node.js版本是否符合要求，删除已安装的依赖文件夹后重新执行安装命令即可

内容的提问来源于stack exchange，提问作者djarvis