Windows下VSCode终端按Ctrl-C无法中断Docker run进程

我正在开发一个默认不会退出、无优雅退出逻辑的Docker容器。为避免推送至Git并等待CI构建的开销，在Windows 11系统上安装了配置为WSL 2后端的Docker Desktop，用于本地构建和测试容器。

在VSCode终端的PowerShell 7.2.6中执行docker run --rm -p 80:80 my_container_image命令后，容器正常运行，但按下Ctrl-C试图中断进程时无任何反应，只能使用终端的终止功能。

尝试过的操作 #

• 在终端中按下Ctrl-C

预期结果 #

• 进程退出
• 终端打印^C

实际结果 #

• 无任何反应

原因及解决办法 #

核心原因 #

1. 容器主进程未处理信号：容器主进程没有实现优雅退出逻辑，无法捕获Ctrl-C发送的SIGINT信号，导致Docker无法通过该信号终止容器，进而docker run进程也不会响应中断。
2. WSL2后端的信号传递问题：Windows环境下的PowerShell与WSL2后端的Docker守护进程之间，信号转发可能存在延迟或失效，导致Ctrl-C的中断信号无法正确传递到容器内进程。

解决办法 #

1. 给容器添加init进程（最快捷）

执行docker run时加上--init参数，让Docker内置的轻量级init进程tini负责管理容器内的信号传递，它会将外部的SIGINT信号转发给容器主进程，触发退出：

docker run --rm --init -p 80:80 my_container_image

2. 手动终止容器

如果不想修改启动命令，可新开一个终端，先通过docker ps获取容器ID，再执行：

• 优雅终止（先发送SIGTERM，超时后强制杀死）：

docker stop <容器ID>

• 强制杀死（立即发送SIGKILL）：

docker kill <容器ID>

3. 调整VSCode终端配置

打开VSCode设置，搜索terminal.integrated.sendKeybindingsToShell并设置为true，确保终端将键盘快捷键直接传递给shell进程，提升信号传递的可靠性。

4. 修改容器内进程的信号处理逻辑

如果需要长期解决，可在容器的启动脚本或主程序中添加SIGINT信号捕获逻辑。比如在Shell脚本中加入：

trap "exit 0" SIGINT

让进程收到Ctrl-C时正常退出。

内容的提问来源于stack exchange，提问作者Nicole O'Connor