vscode重装日记

2026年9月20日星期日·#杂七杂八技术·1865 字 9 分钟·
-浏览量
·
简介

我是一个重度强迫症+完美主义者

众所周知我是一个重度强迫症+完美主义者#

重装完电脑,vscode还没配置环境所以倒腾了一下(注意:本篇部分由ai总结(真的是部分,我真不是懒))

需求其实特别朴素#

我的环境:WinLibs 的 MinGW-w64 GCC 16.2.0 装在 G:\mingw64,Python 3.11.9 在系统目录,编辑器是 VS Code。

想要的东西列表很短:

  • F5 一键编译 + 运行
  • 弹独立黑窗口,不要 VS Code 内置终端
  • 能 cin / input() 交互
  • 跑完别立刻消失,停在「按任意键继续」
  • 按完键自己关掉

Dev-C++ 二十年前就做到的事。我当时想,十分钟吧。

后来发现,报错主要有两个来源:VS Code 的配置层级,和 Windows 命令行对引号的处理。前者是知识问题,查一下就懂;后者是纯粹的玄学,而且它藏挺深。

还有一个我想紫砂的地方 —— 我用户名是 William Chih,中间有个空格。

C:\Users\William Chih\Desktop\projects\test.cpp
↑ 这里的空格,后面会反复咬我

一:VS Code 的配置#

先搞清楚一件事。VS Code 的配置分两层:

层级位置优先级
用户级%APPDATA%\Code\User\低
工作区级项目目录下的 .vscode\高

我平时写代码很散,桌面上随便一个文件夹就开写,不可能每个文件夹都建一份 .vscode。所以这次全部改在用户级,目标是「任何盘符任何文件夹,打开就能 F5」。

三个文件的分工:

  • settings.json —— 全局设置。VS Code 支持把 launch 配置直接写进用户级 settings.json,这样就不用每个项目放 launch.json 了,这是整个方案的起点。
  • tasks.json —— 任务。注意用户级 tasks.json 只支持 shell 和 process 两种类型,C/C++ 扩展默认的那种 cppbuild 类型在用户级是无效的,得自己写。
  • keybindings.json —— 快捷键。后面会讲,这个文件是破局的关键。

二:活动文件可能是任何语言#

很快踩到第一个实际 bug。我在 test.cpp 里写着写着,切到 test.py 写两行,回头按 Ctrl+Shift+B 编译 —— 报错:

ld.exe: test.py: file format not recognized; treating as linker script

原因很直白:默认构建任务用的是 ${file},也就是当前活动文件,而它无条件绑死了 g++。活动文件是什么它就喂什么。

修法也很直白:加一层按扩展名分派的调度脚本 compile_c.bat:

Terminal window
.cpp/.cc/.cxx -> g++ -std=c++17
.c -> gcc -std=c17
其它 -> 打印 [skip],exit /b 0

三:弹窗返工了三次#

第一次:闪一下就没了#

黑窗口一闪而过,什么都看不清。两个原因:

  1. 自弹窗那行写的 start "Title" cmd /c ""%~f0"",没把源文件传进去,子进程只能赌环境变量继承到了;没继承到就 exit /b 1,窗口自然瞬间消失。
  2. 用了 /c 而不是 /k。/c 是跑完就关,/k 是跑完留在屏幕上。

第二次:按完键不关窗#

窗口留住了,结尾也有 pause,但按完键窗口还杵在那儿。因为我写的是 exit /b %RC%。

/b 的意思是「只退出这个批处理脚本」,而承载它的 cmd 进程还活着 —— 窗口当然不关。去掉 /b,变成 exit %RC%,cmd 进程跟着一起结束,窗口才真的消失。同时保留 /k:这样脚本中途异常退出时窗口不会消失,你还来得及看报错。

四:那个报错,和它背后真正的凶手#

然后是重头戏。运行 Python 时弹窗里出现:

'C:\Users\William' 不是内部或外部命令,也不是可运行的程序
或批处理文件。
请按任意键继续. . .

一开始我以为是脚本里参数没加引号,还让ai改了好几轮,一直没好。

测试一下#

写了几串代码,直接给cmd

命令行cmd 的反应
cmd /c "C:\...\test.exe"(加引号)'\"完整路径\"' 不是内部或外部命令
cmd /c C:\Users\William Chih\...(不加引号)'C:\Users\William' 不是内部或外部命令
debugpy 全程不加引号同上

只有「路径完全没加引号」才会产生这个报错,和用户的报错一字不差。所以命令行里一定有一处裸奔的 C:\Users\William Chih\...,被 cmd 在空格处劈成了两半。

至于那句「请按任意键继续」—— 我的脚本里确实有 pause,但那时候它压根没被执行到。这句是 VS Code 的 Windows 外部控制台自己追加的 & pause。这是个关键线索:走的是 launch 配置,根本没走我的 bat。

那 F5 为什么没走到我的任务?#

我的 keybindings.json 里是这样写的:

{
"key": "f5",
"command": "workbench.action.tasks.runTask",
"args": "Python: 运行当前文件(cmd 弹窗)",
"when": "editorLangId == python"
}

问题出在 when。editorLangId 这个上下文只在焦点停在编辑器里时才成立。 你刚关掉弹窗、或者焦点跑到终端上,条件就成了假 —— F5 于是静默退回 VS Code 默认的「启动调试」,走进 launch 配置,撞上外部控制台的引号坑。

顺带一提,cmd /c 那套引号剥离规则(什么情况下剥掉首尾引号、什么情况下保留)我试了无数遍也没不知道。官方文档写了一大段,我的结论是:直接绕开。

最终方案#

绕开的办法只有:一个参数都不传,全部走环境变量。

1. 一个脚本搞定所有语言#

run_auto.bat,按扩展名分派:

Terminal window
@echo off
setlocal
if "%VS_POPUP%"=="1" goto do_run
if not "%~1"=="" set "VS_SRC=%~1"
if "%VS_SRC%"=="" goto no_src_quiet
set VS_POPUP=1
start "VSRunner" cmd /k "%~f0"
exit /b 0
:do_run
...

几个关键点:

  • start "VSRunner" cmd /k "%~f0" —— 只有两个引号,完全避开剥离规则。源文件靠子进程继承环境变量 VS_SRC 拿到(setlocal 不会清掉它)。
  • start 的标题不能带空格,否则会被拆成两半。
  • 结尾 exit %RC%,不带 /b。
  • VS_SRC 为空时走 :no_src_quiet,直接退出不 pause,否则在 VS Code 任务里会卡住终端。

2. F5 不带任何 when#

{
"key": "f5",
"command": "workbench.action.tasks.runTask",
"args": "运行当前文件(自动识别 Python / C / C++)"
},
{
"key": "ctrl+f5",
"command": "workbench.action.debug.start"
}

F5 无条件跑任务,Ctrl+F5 才是真正的断点调试。

3. launch 配置砍到只剩调试#

launch 从 4 条砍到 2 条,只留 调试(断点/单步)[C/C++] 和 [Python]。Python 的 console 全部改成 integratedTerminal —— externalTerminal 就是引号坑的重灾区。

运行这件事彻底交给 F5 → 任务 → bat,不再经过任何 debug adapter。 这是整个方案的核心思路:既然控制不了 debug adapter 怎么拼命令行,那就别让它参与。

4. 验证#

[.py] marker=true 823ms 输出干净
[.cpp] marker=true 2045ms 输出干净
[.txt] exit=1 [error] Unsupported file type: .txt

顺手修的一个真 bug#

搞完环境,回来写代码,编译器给了这么一条:

warning: 'void* memset(void*, int, size_t)' writing to an object of type
'struct std::pair<int, int>' with no trivial copy-assignment [-Wclass-memaccess]

来自这么一个模板:

template <class T>
struct array2d {
T a[N];
void init(int val = 0) { memset(a, val, sizeof(a)); }
};

T = std::pair<int,int> 时,memset 是按字节涂写对象、绕过构造函数的,未定义行为。现在可能碰巧能跑,换个编译器或开 O2 就可能对不上。

改成按类型分派,if constexpr 在编译期就定死分支:

void init(int val = 0) {
if constexpr (std::is_constructible_v<T, int>)
std::fill(a, a + N, T(val)); // int/char/... 按 val 填(0 或 -1)
else
std::fill(a, a + N, T{}); // pair / 自定义结构体 -> 值初始化清零
}

行为和原来的 memset 完全一致,但不再是 UB。std::fill 填连续 int 时编译器照样优化成 memset,没有性能损失。

评论区

看板娘
公告
欢迎关于我的介绍

欢迎来到奇怪的博客,我是一名热爱JAVA,C++,AI等技术的偏执学家

查看详情
音乐
封面

音乐

暂未播放

0:00
0:00
暂无歌词
标签
# 技术7# 日常6# 博客1
目录
工具

隐私政策

更新日期: 2026 年 7 月 15 日
生效日期: 2026 年 7 月 15 日

适用范围#

本政策适用于 Qiguai的博客(以下简称“本站”)。本站是个人博客,用于发布和分享内容;不提供账户注册、支付、定位或广告投放服务。访问本站、发表文章评论或在留言板留言前,请阅读本政策。

信息收集与使用#

本站只在提供内容、评论和留言功能,以及维护站点安全所需的范围内处理信息。

  • 访问与统计信息:访问页面时,统计服务可能处理访问时间、页面地址、来源页、浏览器和设备相关信息,用于了解内容访问情况、排查故障和改进站点。
  • 评论信息:使用文章评论功能时,Waline 可能处理您主动提交的昵称、邮箱、站点链接和评论内容;还可能处理 IP 地址等必要信息,用于防止垃圾评论、滥用和维护服务安全。评论内容、昵称和站点链接(如填写)可能公开展示在文章下方;邮箱不会公开展示。
  • 留言信息:留言板使用 Waline /guestbook/ 频道。Waline 可能处理您主动提交的昵称、可选邮箱、站点链接、留言内容和图片,以及浏览器、操作系统、IP 地址等必要的反滥用信息。默认情况下,留言图片以内嵌数据随留言提交;如站点维护者配置了远程图片上传接口,图片会先发送至该接口并在留言中保存返回的图片地址。留言内容、昵称、图片和站点链接(如填写)可能公开展示;邮箱和 IP 地址不会在留言板公开展示。
  • AI 对话信息:使用 AI 搜索时,本站会处理您提交的问题以及最近 6 条对话历史,用于检索博客内容并生成回答。问题和对话历史会发送至 ModelScope,或在第三方接口不可用时由 Cloudflare Workers AI 处理。请勿在 AI 对话中提交密码、Token、身份证件、联系方式或其他敏感信息。

请不要在评论或留言中提交身份证件、银行卡、住址、密码或其他不必要的敏感个人信息。

第三方服务#

为实现本站功能,以下第三方会在各自服务范围内处理相关数据:

  • Umami:用于匿名化的网站访问统计和出站链接点击统计,帮助我了解本站的使用情况。
  • Waline:用于文章评论、留言板及访问量统计。服务会按照其自身规则处理您在评论或留言时提交的信息及必要的反滥用信息。
  • Cloudflare:为本站提供静态资源分发、AI Worker、Vectorize 和相关基础设施。留言板不使用项目 Worker 或 KV 存储。
  • ModelScope:为 AI 搜索提供文本向量和对话模型服务,会处理您提交的问题及发送给模型的最近对话历史。
  • Cloudflare Workers AI:在未配置第三方 AI 接口时提供文本向量和对话模型服务,并处理相同的 AI 请求数据。
  • unpkg:用于加载 Waline 的前端脚本、样式和表情资源;请求这些资源时,您的浏览器会与该服务建立连接。

第三方服务可能有独立的隐私政策和数据保存规则。请在使用相关功能前查阅其规则;本站无法控制其独立的数据处理活动。

本站主要使用浏览器本地存储(Local Storage 或 Session Storage)保存使用偏好,例如主题颜色、明暗模式、文章列表视图和音乐播放设置。留言板会在本地保存匿名资料、未发送草稿和登录状态,以便恢复输入与会话;管理员登录状态仅保存在当前会话。AI 搜索的会话标题和完整对话也会保存在当前浏览器的 Local Storage 中,最长保存 7 天;您可以在 AI 面板中使用“清空全部会话”立即删除这些数据。

本站不主动设置用于广告定向的第一方 Cookie。评论、统计或资源服务可能按照其自身规则使用 Cookie 或类似技术。您可以通过浏览器设置查看、删除或限制 Cookie 和本地存储;清除后,部分偏好或互动状态可能会恢复为默认值,评论功能也可能受到影响。

信息公开、保存与安全#

评论和留言属于公开互动内容,提交后可能被搜索引擎收录、被他人引用或在缓存中短暂保留。请谨慎决定发布内容。除非您提出删除请求、内容违反规则或法律法规另有要求,公开内容会持续保留以维持讨论上下文。

本站会采取合理措施保护数据安全,包括使用 HTTPS、输入校验、内容转义和访问频率限制。但互联网传输和第三方服务均无法保证绝对安全,请理解并自行承担公开发布信息的相应风险。

你的权利#

你可以通过 3530002633@qq.com 联系我,申请查询、更正或删除由本站直接保存的评论、留言或相关公开内容。为保护他人权益,请在请求中提供足以定位内容的信息,并说明你与该内容的关系;必要时可能需要进行合理核验。

对于由 Waline、Umami、Cloudflare 或 unpkg 独立处理的数据,你也可以直接向对应服务提供方行使相关权利。删除公开评论或留言后,第三方缓存、搜索引擎索引或他人转载的副本可能无法立即同步删除。

未成年人条款#

未满 14 周岁的未成年人应在监护人同意和指导下使用本站的评论、留言等互动功能。监护人如发现未成年人未经同意提交了个人信息,可通过上述联系方式与我联系,我会在合理范围内协助处理。

政策更新与联系#

我可能因本站功能或适用规则变化更新本政策,更新后的版本将在本站公布并标明日期。继续使用相关功能即表示你已阅读并理解更新后的政策。

如对本政策或数据处理有疑问,请联系 3530002633@qq.com。

用户协议

更新日期: 2026 年 5 月 19 日
生效日期: 2026 年 5 月 19 日

适用范围#

本协议适用于你访问 Qiguai的博客,以及使用文章评论、留言板等互动功能的行为。继续浏览本站或提交评论、留言,即表示你已阅读、理解并同意遵守本协议及本站的隐私政策。

评论及留言规则#

请在交流中保持友善、理性和尊重。你不得利用本站发布、传播或实施以下行为:

  • 发布任何违反中华人民共和国法律法规的内容。
  • 发布任何侵犯他人合法权益的内容,包括但不限于隐私、名誉、肖像、著作权、商标权和其他知识产权。
  • 恶意攻击、辱骂、骚扰、威胁、歧视其他用户或任何第三方。
  • 发布垃圾广告、恶意推广、刷屏、灌水,或与讨论主题明显无关的重复内容。
  • 利用本站进行网络诈骗、钓鱼、传播恶意软件,或发布可能危害网络和信息安全的内容。
  • 绕越或试图绕越本站的审核、限流、封禁等管理措施。
  • 冒充他人、伪造身份,或收集、公开他人的个人信息。

内容与访问管理#

你应对自己发布的评论和留言负责,并保证拥有发布该等内容所需的合法权利。论坛管理员有权在不另行通知的情况下删除违规内容、限制或封禁违规账号,或限制其继续使用本站互动功能。

如发现涉嫌违法犯罪、严重侵权或危及本站安全的内容,本站可保留相关记录,并在法律法规要求或必要时向有关部门提供协助。对管理措施有疑问时,可通过文末联系方式说明情况;本站会结合实际情况处理,但不承诺恢复已删除内容或访问权限。

知识产权与内容授权#

本站原创文章、页面设计和其他受保护内容的权利归作者或权利人所有。未经授权,请勿复制、转载、镜像或用于商业用途;法律法规允许的合理使用除外。

你发布评论或留言时,授予本站为展示、存储、备份、审核、删除和维护互动功能所必需的非独占、免费的使用许可。该许可不改变你对原创内容依法享有的权利。

免责声明#

本站内容仅用于个人记录、学习交流和一般信息参考,不构成任何专业意见、承诺或担保。你应结合自身情况独立判断,并对据此采取的行动负责。

评论、留言和外部链接中的内容由其发布者或运营者负责,不代表本站立场。本站会在合理范围内处理明显违规内容,但不保证所有内容均及时发现,也不对第三方网站的可用性、内容、安全性或隐私实践承担责任。

因网络故障、不可抗力、第三方服务异常、维护升级或超出合理控制范围的原因导致本站暂时无法访问、内容延迟或数据丢失的,本站会尽力恢复,但不承担由此产生的间接损失。

未成年人条款#

未满 14 周岁的未成年人应在监护人同意和指导下使用评论、留言等互动功能。监护人应协助未成年人理解本协议,并对其使用行为进行必要的引导。

其他条款#

我可以根据本站功能、管理需要或法律法规变化更新本协议,更新后的版本将在本站公布并标明日期。继续使用本站即视为接受更新后的协议。

本协议的订立、执行和解释适用中华人民共和国法律。因本协议或使用本站产生争议时,双方应先友好协商;协商不成的,依法向有管辖权的人民法院解决。

如对本协议或内容管理有疑问,请联系 3530002633@qq.com。