VS2022 远程调试 Ubuntu 普通用户免密 sudo gdb 配置文档

一、目标

实现VS2022（MSBuild .vcxproj项目）远程调试 Ubuntu22.04 程序，普通用户无需手动输入密码，直接以 sudo 权限启动 gdb 进行调试，不依赖任何外部脚本。

二、Ubuntu端配置（普通用户）

1.安装依赖

bash sudo apt update sudo apt install -y gdb gdbserver openssh-server

2.配置免密sudo权限

1. 编辑 sudoers 文件：

bash sudo visudo

1. 在文件末尾添加以下内容（将a替换为你的 Ubuntu 用户名）：

sudoers a ALL=(ALL) NOPASSWD: /usr/bin/gdb, /usr/bin/gdbserver

1. 保存并退出（按Ctrl+O→ 回车 →Ctrl+X）。

1. 验证配置是否生效（不提示输入密码即成功）：

bash sudo -n /usr/bin/gdb --version

3.关闭ptrace限制

为了让 gdb 能够 attach 到进程，需要临时关闭 ptrace 限制：

bash echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope

如需永久生效，可修改/etc/sysctl.d/10-ptrace.conf文件，设置kernel.yama.ptrace_scope = 0，然后执行sudo sysctl -p生效。

三、VS2022项目配置（MSBuild）

1.远程连接设置

在 VS2022 中配置远程 SSH 连接：

1. 顶部菜单 → 工具 → 选项 → 跨平台 → 连接管理器 → 添加。

1. 输入 Ubuntu 服务器 IP、端口（默认 22）、用户名（a）和密码，测试连接成功。

2.项目调试属性配置

右键你的项目 → 属性 → 配置属性 → 调试，按如下设置：

配置项	值	说明
要启动的调试器	远程 GDB 调试程序
启动前命令	`sudo pkill -9 -f "$(CommandArguments)" 2>/dev/null	true`
远程调试计算机	192.168.0.68 (username=a, port=22, authentication=Password)	选择你已配置的远程连接
调试模式	gdb	必须设置为gdb模式
程序	~/$(RemoteProjectRelDir)/bin/$(ProjectName)	远程程序路径，保持默认或根据项目修改
程序参数	-p m18 -n $(RemoteProjectRelDir) -f ~/$(RemoteProjectRelDir)/config/$(RemoteProjectRelDir).json	根据你的程序需求设置
工作目录	$(RemoteOutDir)
调试程序路径	/usr/bin/sudo /usr/bin/gdb	核心配置，直接使用sudo启动gdb，无需脚本
远程调试器类型	gdb

其他配置项保持默认即可。

四、验证与调试

1. 点击 VS2022 的 “启动调试” 按钮（或按 F5）。

1. VS 将自动通过 SSH 连接到 Ubuntu，执行命令：

bash /usr/bin/sudo /usr/bin/gdb ~/你的项目路径/bin/你的程序名

1. 成功进入调试模式，可正常设置断点、查看变量等。

五、常见问题排查

问题	可能原因	解决方法
sudo: password required	sudoers 配置错误	检查用户名、gdb 路径是否正确，使用which gdb确认路径
ptrace: Operation not permitted	ptrace 限制未关闭	执行 `echo 0	sudo tee /proc/sys/kernel/yama/ptrace_scope`
调试器无法启动	调试程序路径错误	确认/usr/bin/sudo和/usr/bin/gdb路径正确
VS 无法连接	SSH 配置错误	检查 IP、端口、用户名和密码，测试 SSH 连接