必须重装VSCode至纯英文无空格路径，因Windows 11对含中文或空格的路径（如C:Users张三AppData）解析更严格，导致插件postinstall脚本在CMD/PowerShell中报ENOENT或卡在“Installing…”；便携版需手动赋予文件夹“完全控制”权限。
插件安装路径含中文或空格直接报错
Windows 11 对路径解析更严格，C:Users张三AppData 或 C:Program Files (x86)Microsoft VS Code 这类路径会让插件的 postinstall 脚本在 PowerShell/CMD 中解析失败，现象是卡在 “Installing…” 或报 ENOENT: no such file or directory。
必须用纯英文、无空格、无括号的路径安装 VSCode，例如：D:scode 或 E:devscode。已装在问题路径的，不能直接剪切粘贴迁移——NTFS 权限会丢失，得卸载后重装。
- 便携版用户解压后，右键文件夹 → “属性” → “安全” → “编辑”，给当前用户勾选“完全控制”
- 不要勾选快捷方式的“以管理员身份运行此程序”，否则每次启动都提权，插件写入权限混乱
- 杀毒软件实时扫描、NTFS 加密（EFS）、WSL 挂载点权限异常，也可能导致
Access is denied却查不到原因
多个插件争抢同一语言服务路径
典型如 Python：旧版 ms-python.python 和 ms-python.pylance 同时启用，Pylance 实际已内置语言服务，但旧插件仍尝试注册 python.defaultInterpreterPath，导致路径被覆盖或指向 node_modules/.bin/python 这类假链接。
解决不是删哪个，而是明确归属——禁用 ms-python.python，只留 ms-python.pylance 和 ms-python.vscode-pylance（注意版本兼容），并在 settings.json 中显式锁定解释器：
"python.defaultInterpreterPath": "C:\Python311\python.exe"
- 检查
Developer: Show Running Extensions，状态为Activation failed的插件大概率因路径依赖不匹配被挂起 - 某些插件（如 MATLAB 插件）会扫描项目根目录下所有
bin/或.env，误读 Node.js 工具链路径，需用python.terminal.executeInFileDir等配置隔离
launch.json 中 env 和 pathMappings 路径映射失效
launch.json 的 env 字段不是合并，而是后加载配置覆盖前一个；pathMappings 也不是字符串替换，而是前缀匹配 + 路径规范化后对比——容器内路径 /app/src 和宿主机 /Users/me/project/src 若没对齐真实工作目录，映射必失败。
关键动作只有两个：
- 用
envFile拆分环境变量："envFile": "./.env.python"和"envFile": "./.env.node"，各自独立，互不干扰 -
pathMappings必须用绝对路径，且宿主机路径要realpath .验证是否含符号链接；Windows 用户必须写成/c/project，不能用C:project - 容器内执行
docker exec -it <container> pwd确认实际工作目录，别信 Dockerfile 的WORKDIR
插件自定义 extensions-dir 与用户配置冲突
用 code --extensions-dir /custom/path 指定插件目录时，VSCode 不会自动迁移已有插件，也不会同步 settings.json 中的插件相关配置（如 editor.defaultFormatter），容易出现“插件装了但不起作用”。
这不是 bug，是设计行为——新路径下插件默认未启用，且语言关联、格式化优先级等仍按原 ~/.vscode/extensions 下的注册逻辑走。
- 首次使用自定义路径，必须手动启用对应插件，并在该工作区的
.vscode/settings.json中重新声明关键配置 - 多工作区共用同一
--extensions-dir时，不同项目可能要求不同插件版本，建议配合extensions.autoUpdate: false控制升级节奏 -
Developer: Show Running Extensions显示的插件路径，才是它实际加载的位置，别只看extensions-dir参数
realpath 或一次 Developer: Show Running Extensions 查看，往往比改十次 settings 更有效。 
