STM32CubeIDE Run Configurations中Startup页main断点置灰如何禁用

问题根因 #

该选项处于灰化不可编辑状态，通常由两类场景触发：

• 工程通过STM32CubeMX联动生成代码时，自动同步了全局调试模板的锁定配置，用户无法直接在当前Run Configuration窗口内修改单条勾选状态
• 1.11.0及更早版本的CubeIDE存在已知适配bug，关联CubeMX的工程会直接锁定Startup标签页的断点设置项

具体操作步骤 #

• 优先尝试联动开关解锁
  切换到Run Configurations窗口下的 Debugger 标签页，找到「Set breakpoint at main function」独立选项，直接取消勾选。该选项与Startup标签页的灰化选项为双向联动状态，修改Debugger页的开关后，Startup页的选项会自动恢复可编辑状态，同步取消对应勾选即可生效。
• 若Debugger标签页的选项也处于灰化状态，直接修改工程配置文件解锁
  打开工程根目录下的.cproject文本文件，检索关键词breakpoint_at_main，将匹配到的属性值从true修改为false，保存文件后重启STM32CubeIDE。重启后重新打开Run Configurations窗口，Startup标签页的对应选项即可恢复正常编辑，按需取消勾选即可禁用自动断点。
• 修改全局默认配置，避免后续新建工程重复出现锁定问题
  从顶部菜单栏进入 Window > Preferences > Run/Debug > Launching，定位到STM32 GDB Hardware Debugger的默认启动配置项，进入对应设置页后直接取消「Set breakpoint at: main」的勾选，保存为全局默认模板。后续所有新建工程的调试配置，都不会默认携带main函数入口的自动断点。

单次调试的临时处理技巧 #

如果仅需单次调试跳过main函数断点拦截，无需调整配置，可以在调试会话启动后，直接打开 Breakpoints 调试视图，找到自动生成的main函数断点，右键选择移除或禁用即可。

注意：修改.cproject文件前建议先备份工程，避免配置文件写入异常导致工程无法被IDE正常识别。

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