VSCode 默认不自动折叠 import 区域，需手动添加 #region 注释或启用 PyLance 的语义折叠（python.analysis.semanticFolding: true），后者自 v2023.10 起支持但默认关闭；editor.autoFold 并不存在。

VSCode 打开文件时自动折叠 import 区域，靠的是折叠区域标记，不是语言本身支持

Python、TypeScript 等语言的 import 语句本身不带折叠语法，VSCode 默认不会识别它们为可折叠块。想实现“一打开就收起导入”，必须手动加折叠标记，或者依赖扩展/语言服务提供的语义折叠能力（但目前 Python 官方插件不默认开启 import 折叠）。

实操建议：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 在 import 块前后插入 VSCode 识别的折叠注释：

  // #region imports
  import os
  import sys
  from pathlib import Path
  // #endregion

• 确保设置中启用了基于注释的折叠："editor.foldingStrategy": "auto"（默认值，一般不用改）
• 注意：这种写法对所有语言都有效，但会污染源码——尤其团队协作时，需提前对齐风格

Python 文件想无侵入式折叠 import，得靠 python.languageServer + 折叠配置

PyLance（微软官方 Python 插件）从 v2023.10 起支持语义折叠（semantic folding），其中包含 import 区域识别，但默认关闭。

实操建议：

• 确认已安装并启用 ms-python.vscode-pylance
• 在 settings.json 中添加：

  "python.analysis.semanticFolding": true

• 重启窗口或重载窗口（Developer: Reload Window）后，import 块左侧会出现折叠控件，但「打开即折叠」仍需配合下面的自动展开控制
• 该功能仅对标准 import / from ... import 有效，不识别 __import__() 或动态导入

editor.autoFold 不是开关，VSCode 没有全局「打开即折叠 import」的内置选项

很多人搜到 editor.autoFold 并尝试设为 true，但这个配置根本不存在——VSCode 当前（v1.90）没有名为 autoFold 的设置项。这是常见误解来源。

真正影响初始折叠状态的是：

• "editor.foldLevel": 1 —— 控制默认展开到第几级（数字越小展开越少），但对 import 无效，因为它不属大纲层级
• "editor.showFoldingControls": "mouseover" —— 只控制折叠按钮显示时机，不影响行为
• 唯一能模拟「自动折叠」效果的方式：用宏扩展（如 geddski.macros）+ 命令序列，在文件打开后立即执行 editor.foldAllBlockComments 或 editor.foldLevel1，但不稳定且易误折其他内容

最稳的方案：用 region 注释 + 文件关联设置，兼顾可读性和自动化

如果项目允许少量注释侵入，这是目前唯一可靠、跨语言、不依赖插件版本的解法。关键是把 region 写得轻量，并通过设置让 VSCode 在特定类型文件里默认折叠它。

实操建议：

• 在 settings.json 中按语言配置折叠级别：

  "[python]": {
    "editor.foldLevel": 1
  }

  再配合 // #region imports，就能让 import 区在打开时处于折叠态
• 避免用空行或长横线分隔 import —— VSCode 不识别这种视觉分隔为折叠边界
• 注意缩进一致性：#region 必须和后续 import 语句同级缩进，否则折叠可能错位或失效

实际用下来，语义折叠（PyLance）最干净，但得接受它只在新版本生效；region 注释最稳，但要改代码。两者选哪个，取决于你能不能说服队友接受那一行 // #region imports。