VSCode命令行参数（如--user-data-dir、--disable-extensions）仅控制编辑器自身行为，不给用户程序传参；给Python/Java程序传参必须配置launch.json的args字段，且仅F5调试或Run and Debug面板启动时生效。
VSCode 命令行本身不支持“配置启动参数”这种说法——code 命令的参数是控制编辑器自身行为的（比如开新窗口、禁用扩展），而不是用来给你的 Python/Java 程序传参的。真正要传参给代码，得靠 launch.json 里的 args 字段，且只在 F5 调试时生效。
code 命令能直接控制什么？
这些参数作用于 VSCode 进程本身，不是你的脚本：
-
--user-data-dir="/path/to/config：切换整套用户环境（含 settings.json、扩展、快捷键），适合多项目隔离；路径含空格必须加引号 -
--disable-extensions：彻底禁用所有扩展，排查插件干扰最有效 -
--read-only /path/to/file：以只读方式打开单个文件，防止误改配置或日志 -
--disable-gpu：解决界面闪烁或高 CPU 占用，强制软件渲染 -
--prof-startup --trace-renderer：生成启动性能日志，定位卡顿根源 -
--wait：仅在首次启动 VSCode 实例时阻塞终端；已有进程在后台则立刻返回
注意：--settings 和 --extensions-dir 不是合法参数，执行会报 Unknown argument；code --help | grep settings 输出为空可验证。
想给 Python/Java 程序传命令行参数？必须配 launch.json
右键“Run Python File”、Code Runner 插件、甚至 code . 启动后点绿色虫子按钮，默认都不读 args。只有 F5 或从“Run and Debug”面板选中配置后启动才生效。
-
args必须是字符串数组：["--input", "data.txt", "-v"]，不能写成"--input data.txt" -
program字段只能是纯路径，如"${file}"或"${workspaceFolder}/main.py"，不能拼参数 - 含空格的值直接写：
"--name", "Alice Smith"→ Python 的sys.argv收到的就是完整字符串 - 参数本身要带 JSON 引号？得双重转义：
"--config", "{\"port\":8080}" - 务必显式设置
cwd（工作目录），否则--input data.txt可能因相对路径错位而找不到文件
为什么 F5 启动后程序立刻报错或断点不命中？
常见原因是参数解析逻辑没做隔离。调试器加载模块时，会先执行所有顶层语句，此时 args 还没传进去。
- 所有依赖参数的操作（
open(sys.argv[1])、argparse.parse_args()、连数据库）必须严格放在if __name__ == "__main__":块内 - 不要在 import 阶段或模块顶层就调用需要参数的函数
- 调试时第一句建议加
print(sys.argv)，确认是否真收到了你配的值 - 每次 F5 前盯一眼左下角显示的调试配置名——VSCode 不会记住上次选的是哪个，选错配置
args就完全失效
如何让“Debug Python File”按钮也带参？
默认按钮走的是简化流程，不读 args。要让它生效，需两步硬性匹配：
- 在
launch.json对应配置中添加"purpose": ["debug-in-terminal"] - 该配置的
name字段必须**完全等于**"Python: Current File (Integrated Terminal)"（括号、大小写、空格都不能错） - 同时加上
"console": "integratedTerminal"，否则可能 fallback 到内部调试器，仍不生效
这个组合是唯一能让顶部绿色虫子图标和 Ctrl+F5 也带上 args 的方式。其他任何命名或缺项都会失败。
