code命令不可用需先修复PATH：macOS/Linux通过Shell Command安装，Windows安装时勾选Add toPATH或手动添加bin路径；WSL须用Remote-WSL扩展。
code 命令根本用不了？先确认 PATH 是否生效
绝大多数“启动失败”其实卡在第一步：终端压根不认识 code。这不是配置问题，是命令根本没注册进系统。
验证方式很简单：code --version 有输出才说明可用；如果报 command not found 或 The term 'code' is not recognized，别往下试路径参数，先修这个。
- macOS/Linux：打开 VS Code 图形界面 →
Cmd+Shift+P→ 输入并执行Shell Command: Install 'code' command in PATH→ 关闭终端重开 - Windows：安装时必须勾选
Add to PATH；若已安装却失效，手动把C:\Users\{user}\AppData\Local\Programs\Microsoft VS Code\bin加进系统环境变量Path - WSL 用户注意：
code .在 WSL 终端里必然失败，因为那是 Windows 主机上的命令；要用 Remote - WSL 扩展，再配code .自动转发
--user-data-dir 是唯一真正“换配置”的方式
VS Code 命令行不支持 --settings=./my-settings.json，也不认 --extensions-dir 作为配置切换手段——这些参数要么不存在，要么静默忽略。
真正能隔离整套用户环境（含 settings.json、快捷键、扩展启用状态、工作区历史）的，只有 --user-data-dir。
- Linux/macOS：
code --user-data-dir="/path/to/my-backend-config" ./src - Windows：
code --user-data-dir="C:\configs\frontend" .\my-app - 首次运行会自动初始化该目录，后续启动复用其中的
settings.json - 扩展也完全隔离：你在该目录下装的插件，不会出现在默认 VS Code 里，反之亦然
- 路径含空格？必须加英文双引号，否则 Windows 下解析失败
-g 参数才是精准跳转文件+行列的正确写法
只写 code src/main.py 是打开文件，但不会定位；想直接跳到第 32 行第 5 列，必须带 -g（goto）参数。
-
code -g "src/main.py:32"：打开并跳到第 32 行 -
code -g "src/main.py:32:5"：再精确定位到第 5 列（冒号分隔，不是逗号） - 路径哪怕没空格，也建议加引号——zsh 等 shell 遇到冒号可能提前截断参数
- 文件不存在时，VS Code 不报错，而是新建一个未保存的空白标签页，容易误判为“跳转成功”
常见参数组合与避坑点
单个参数好记，但组合起来容易互相干扰。比如 --wait 和已有实例共存时行为就和直觉相反。
-
code -r -w .：复用窗口 + 阻塞等待关闭 —— 但--wait只在首次启动 VS Code 进程时生效；后台已有实例时它立刻返回，不等你编辑完 -
code -n --disable-extensions .：强制新开窗口 + 彻底禁用所有扩展，适合排查插件冲突，比改settings.json更干净 -
code --no-sandbox：仅限容器或受限环境调试用，有安全风险，生产环境勿加 - 路径别用波浪线：
code ~/project会被当字面路径处理，应先cd再code .，或用绝对路径
最常被忽略的一点：VS Code 的配置加载是分层的——命令行参数只能覆盖部分设置（如是否禁用扩展），但像 editor.tabSize 这类具体值，没有任何命令行 flag 能直接设置。真要项目级统一，得靠 --user-data-dir 配合预置好的 settings.json，或者用工作区 .vscode/settings.json。
