VSCode共享脚本加载慢的根源在于执行链路中间环节:终端启动慢、code-runner缓冲机制、文件监视器扫目录、Python插件冗余。需分别优化终端配置、启用runInTerminal、完善files.watcherExclude、精简Python插件。

VSCode 本身不“加载”共享脚本,所谓“共享脚本加载慢”,实际是终端启动、Python 环境初始化、文件监视器扫目录或 code-runner 缓冲机制在拖后腿——不是脚本问题,是执行链路卡在了中间环节。
终端启动慢导致脚本迟迟不执行
每次点击运行,光等终端弹出来就要 2–3 秒?这基本是 shell 初始化太重或 Python 自动激活虚拟环境造成的。
- Windows 用户检查
terminal.integrated.defaultProfile.windows是否设为powershell.exe;换成commandPrompt或路径明确的git-bash.exe - 禁用 Python 终端自动激活:
python.terminal.launchArgs设为空数组[],同时关掉python.terminal.executeInFileDir - WSL2 用户绝不能从 Windows 资源管理器打开
\wsl$下的项目;必须用Remote - WSL: New Window,确保左下角状态栏显示WSL: Ubuntu
code-runner 执行共享脚本输出延迟或卡住
用 code-runner 运行含 input()、日志流或长时循环的脚本,输出面板会缓冲、丢帧、甚至假死——它根本不是为交互式脚本设计的。
- 强制切到终端执行:
code-runner.runInTerminal设为true - 只保存当前文件:
code-runner.saveFileBeforeRun设为true,code-runner.saveAllFilesBeforeRun必须为false - Python 脚本加
-u参数禁用输出缓冲:"python": "python -u -i $fileName"写进code-runner.executorMap
files.watcherExclude 没配全,共享脚本一改就卡顿
改一行代码,VSCode 卡住半秒才响应?大概率是文件监视器在狂扫 venv、__pycache__ 或 .mypy_cache 这类目录,触发 inotify 句柄耗尽后退化为轮询模式。
- 必须在项目根目录的
.vscode/settings.json中配置(用户级设置无效) - 至少包含:
"**/venv/**": true、"**/__pycache__/**": true、"**/.mypy_cache/**": true、"**/node_modules/**": true - 改完务必关闭整个 VSCode 窗口再重开,否则不生效
Python 插件冗余导致共享逻辑初始化拖慢
共享脚本常被多个 Python 插件反复扫描:Pylance 解析类型、Flake8 检查语法、Black 格式化……哪怕你只点一下运行,后台也在同步加载整个 site-packages。
- 若脚本无调试/测试需求,可全局禁用
ms-python.python和ms-python.pylance - 保留一个 linter:
python.linting.pylintEnabled和python.linting.flake8Enabled别同时开 - 删掉残留配置:
python.defaultInterpreterPath、python.formatting.provider、python.linting.enabled
真正容易被忽略的是:files.watcherExclude 的通配符必须写成 **/venv/**,少一个 * 或漏掉末尾 / 都会失效;而所有优化只在工作区级生效,切记别往用户设置里塞。


















