code命令高效使用需把握三点：路径必须为绝对或当前目录下相对路径（不解析~和变量）；--wait仅在新实例中阻塞，建议搭配--new；调试首选--disable-extensions与--user-data-dir组合。
code 命令不是万能的，但用对参数能省下大量手动操作时间；关键在于路径、窗口复用逻辑和阻塞行为这三点，错一个就白写命令。
code 启动时路径参数必须是绝对路径或当前目录下的相对路径
VSCode 不解析 tilde（~）、不自动 cd、也不展开 shell 变量。你敲 code ~/my-project，它大概率打开空白窗口或报错，不是 bug，是设计如此。
- ✅ 正确做法：先
cd /full/path/to/my-project，再运行code . - ✅ Windows PowerShell 下
code .\src可行；CMD 中建议用code src/或绝对路径，避免反斜杠被当作转义符 - ❌
code $HOME/my-project或code ~\my-project都不会按预期工作 - ⚠️ 脚本中调用时，务必用
$(pwd)或${PWD}拼接路径，别依赖用户当前 shell 的路径习惯
--wait 只在首次启动时阻塞，已有实例则立即返回
这个参数常被用于 Git commit hook 或构建脚本中，要求“编辑完再继续”。但它有个隐藏前提：VSCode 进程必须是这次命令新拉起的。
- ✅ 确保阻塞生效：加
--new强制新开实例，例如code --new --wait package.json - ✅ 若只想编辑单文件且不干扰已有工作区，可搭配
--read-only使用：code --new --read-only --wait README.md - ❌ 单独用
code --wait file.txt，后台已有 Code 进程时，命令秒返回，脚本会误判为“已编辑完成” - ⚠️
--wait对多根工作区（multi-root）支持不稳定，建议只用于单文件或单文件夹场景
--disable-extensions 和 --user-data-dir 是调试黄金组合
当 VSCode 行为异常（卡顿、插件失效、语法高亮消失），第一反应不该是重装，而是快速验证是否扩展或用户配置导致的问题。
- ✅ 快速隔离问题：
code --disable-extensions --user-data-dir /tmp/vscode-test，这样既禁用所有扩展，又不污染真实配置 - ✅ 想保留部分扩展？改用
--extensions-dir指向空目录，再手动--install-extension加回关键插件 - ❌
--disable-extensions不等于“安全模式”，它不重置设置、不清理缓存、也不跳过语言服务器初始化 - ⚠️
--user-data-dir路径必须可写，且不能复用已有 profile 目录，否则可能读取到旧状态
多实例隔离要用 --user-data-dir + --extensions-dir，别只靠 --new-window
--new-window 只控制 GUI 窗口数量，所有窗口仍共享同一套用户数据和扩展环境。真要并行跑两个完全独立的 VSCode（比如一个写前端、一个调试嵌入式 Python），得从数据层切开。
- ✅ 安全隔离启动：
code --user-data-dir ./profile-a --extensions-dir ./exts-a --new - ✅ 配合
--folder-uri可跳过欢迎页并直入指定工作区：code --user-data-dir ./profile-b --folder-uri file:///full/path/to/project - ❌
code -n或code --new-window无法防止扩展冲突或设置互相覆盖 - ⚠️
--user-data-dir路径若含空格或中文，在 Windows CMD 下容易出错，建议用短路径或 PowerShell
真正难的不是记住所有参数，而是理解每个参数背后影响的是哪一层：进程生命周期、GUI 窗口管理、用户配置加载、还是扩展沙箱。比如 --wait 看似简单，但它实际依赖于 IPC 通道是否新建；而 --disable-extensions 并不阻止语言服务器启动——这些细节不踩一次坑很难意识到。
