【配置教程】打通 Sim4Life 与 VS Code：实现 Python 脚本的即时驱动与除错

在进行复杂的生医或通讯电磁模拟时，脚本编写的品质与开发效率至关重要。 Sim4Life 内建的编辑器虽能执行基本任务，但面对大型专案或复杂的 Python API 自动化需求，往往需要更专业的工具支援。 透过 Sim4Life Remote 扩充套件，开发者能将 Visual Studio Code （VS Code） 的专业功能（如： 智慧提示、版本控制、进阶除错）无缝整合至 Sim4Life 的 Python 脚本开发环境中，实现在 VS Code 中即时撰写脚本、在 Sim4Life 中即时驱动模拟的高效工作流。

一、 基础环境搭建与连线

1.到 https://code.visualstudio.com/ 网站下载 VS Code 编辑器

2. 开启 VS Code，按下延伸模块栏位右上方的...，选择 “从 VSIX 安装..."

3. 在 Sim4Life 安装文件夹路径（C：\Program Files\Sim4Life_9.0.0.18809\Python\s4l_remote\v0.3.3） 选择 s4l-remote-0.3.3.vsix 文件

4. 安装完成后 S4L Scripting 模块即显示在 VS Code 扩充插件栏位中

5. 开启 Sim4Life 介面，启动 VS Code 远端连线： 在 Console 视窗选取上方的 Remote Attach 按钮

6.开启自动载入档案设定： 为了让脚本的修改能即时同步，请在 Sim4Life Preferences 的设定中（File | Preferences | Python Options）选取 Editor Automatic Reload Files 后按下 Ok

二、 核心配置：编辑器环境同步

为了让 VS Code 的 IntelliSense 正常运作，我们必须让 VS Code 的 Python 直译器路径与 Sim4Life 内部使用的环境保持一致

1. 取得路径

在 VS Code 界面的搜索字段输入 >S4L： 以显示可用的 S4L 指令，选择 S4L： Get Python Path 获取当前 Sim4Life 版本使用的 python.exe 可执行文件路径

2. 设定直译器

接着执行 VS Code 内建命令 Python： Select Interpreter，并贴上刚刚取得的 Sim4Life Python 路径

3.识别当前连线

（1）在 VS Code 视窗的搜寻栏位选择 S4L： Identify 指令，成功连线后 VS Code 视窗右下角会出现成功连线的讯息

（2）系统会在目前已连线的 Sim4Life 的 Console 视窗会显示讯息： Remote Python Server was contacted

三、 核心功能与指令操作整理

1. 脚本开启与执行

若要在 VS Code 中快速开启目前 Sim4Life 内正在编辑的脚本，请执行 S4L： Open Current Script 指令

2. 代码执行与除错

可直接在 VS Code 中利用调试工具来排查 Sim4Life 脚本中的错误，大幅提升开发效率

执行脚本： 使用指令 S4L： Run Python Script

• 除错脚本： 使用指令 S4L： Debug Python Script

备注： 预设情况下，这些指令会执行「Sim4Life 中目前启用的档案」。 若希望改为执行「VS Code 中目前启用的档案」，请参考底下 “6. 进阶配置“ 说明。

3. 除错期间的 UI 画面更新

当在 VS Code 中进行除错（例如： 设置中断点）时，Sim4Life 的 UI 画面会因为正在执行 Python 程式码而进入冻结状态

• 检视 3D 视窗/模拟树（Simulation Tree）： 执行命令 S4L： Update UI Interactively，这会将控制权暂时交还给 Sim4Life 介面，以便即时检查 3D 视窗或模拟树（Simulation Tree）的状态
• 恢复调试： 检查完毕后，点击 Sim4Life 左下角的通知提示，即可结束交互更新并将控制权交还给 VS Code 调试器（debugger）

4. 多重视窗管理（Multiple Instances）

若同时开启了多个 Sim4Life 专案视窗，除了前面介绍的识别当前连线指令 S4L： Identify 外，扩充套件还内建了安全保护机制

• 安全锁定机制： 为避免在错误的视窗中误触发脚本（例如： 意外执行了 document. NewDocument（） 清空专案），侦测到多个实体时会预设拒绝执行
• 解除锁定： 若确认安全无虞并希望强制执行，可修改设定档中的 s4l_remote.allow_run_if_many_s4l 为 true

5. Python 套件管理

可直接从 VS Code 管理 Sim4Life 环境下的 Python 扩充套件：

• S4L： List Python Packages （列出已安装套件）
• S4L： Install Python Packages （安装新套件）
• S4L： Uninstall Python Packages （解除安装套件）

6. 进阶配置

可透过修改 VS Code 的 settings.json 或设定面板来微调扩充套件的行为

设定项目与用途说明

(1) s4l_remote.application_defining_current_script

决定执行指令时，是以 Sim4Life 还是 VS Code 目前启用的档案为准

• 如果选择以 VS Code 为准，必须同时在 Sim4Life 中开启任意脚本执行权限（在 File | Preferences | Python Options | VS Code Options 勾选 Enable arbitrary script execution）
(2) s4l_remote.auto_update_ui_during_debug

[实验性功能] 决定是否在除错期间自动更新 Sim4Life 的 UI 界面

(3) s4l_remote.extension_port

设定通讯使用的通讯埠（Port）

• 此设定必须与 Sim4Life 内部的设定完全一致（File | Preferences | Python Options | VS Code)

• 一般情况下建议保持预设值，无需修改

S4L Scripting 扩充套件的 Settings 视窗

四、结语

至此，你已经成功解锁了 Sim4Life + VS Code 的“高效开发姿势”。从繁琐的脚本重载到丝滑的断点调试，这套配置不仅能大幅提升你的代码质量，更能让你把宝贵的时间真正花在仿真逻辑的设计上，而不是和编辑器“斗智斗勇”。