VSCode启动参数必须通过code命令行传入，双击或快捷方式无效；路径需绝对或当前目录，不解析~；含空格或中文须加双引号；--wait仅首次启动阻塞终端；launch.json的args仅调试时生效，与code参数无关。
VSCode 启动参数必须通过 code 命令行显式传入，图形界面双击打开或任务栏快捷方式完全不接受任何启动参数。
code 命令启动时路径参数必须是绝对路径或当前目录
VSCode 不解析波浪线 ~，也不自动切换工作目录。你执行 code ~/my-project，它真会去字面路径 /home/user/~/my-project（Linux/macOS）或 C:\Users\user\~\my-project（Windows）找，而不是你家目录下。
- 最稳做法：先
cd进目标目录，再运行code . - 用绝对路径：Linux/macOS 写
code /home/user/my-project；Windows 写code C:\Users\user\my-project - PowerShell 中
code .\src可行；CMD 推荐用正斜杠：code ./src，避免反斜杠被转义 - 路径含空格或中文？必须加双引号：
code "./my project"或"C:\my project"
--wait 参数只在首次启动时阻塞终端
--wait 的作用是让终端等待 VSCode 关闭后再返回控制权，但它只对“首次启动新实例”生效。如果后台已有 VSCode 进程在运行，code --wait . 会立刻返回，根本不会等你编辑完。
- 适合场景：脚本中需要“编辑完再继续执行后续命令”，且确保没有其他 VSCode 实例在运行
- 不适用场景：日常开发中反复调用，因为第二次起就失效了
- 替代方案：用
code --new-window .强制新开窗口，再配合--wait（但依然受限于是否已有实例）
launch.json 中的 args 是调试专用，和 code 启动参数无关
很多人混淆 code 启动参数和 Python 调试时的程序参数。前者控制 VSCode 自身行为（如打开哪个文件夹），后者控制你写的代码运行时接收什么命令行参数，两者完全隔离。
-
launch.json里的"args": ["--verbose", "--input", "data.txt"]只在 F5 启动调试时生效，且每个参数必须单独一个字符串 - 右键“Run Python File”或点击“Debug Python File”按钮默认**不读取**
args字段，除非你额外配置"purpose": ["debug-in-terminal"]并命名配置为Python: Current File (Integrated Terminal) - 想验证参数是否传进去了？在 Python 脚本开头加
import sys; print(sys.argv)
最容易被忽略的一点：VSCode 的 code 命令本身不提供“全局默认工作区”或“记住上次打开路径”的机制——它每次启动都严格按你给的参数或当前上下文决定根目录。依赖路径的操作（比如 pip install -e .、pytest、python -m mypackage）一旦 cwd 错了，报错信息往往不直接提示路径问题，而是抛出 ModuleNotFoundError 或 FileNotFoundError，排查起来绕一圈。
