如何在 VSCode 中为 Python 脚本运行指定工作目录（cwd）-Python教程-PHP中文网

如何在 VSCode 中为 Python 脚本运行指定工作目录（cwd）

本文详解在 VSCode 中通过配置 launch.json 设置 Python 脚本的运行工作目录（cwd）及命令行参数的方法，并补充适用于跨环境部署的代码级工作目录固化方案。

本文详解在 vscode 中通过配置 `launch.json` 设置 python 脚本的运行工作目录（cwd）及命令行参数的方法，并补充适用于跨环境部署的代码级工作目录固化方案。

在 VSCode 中运行 Python 脚本时，默认以当前工作区（workspace folder）为工作目录（cwd）。但实际开发中，脚本常依赖相对路径读取配置、数据或模块（如 ./config.yaml 或 ./data/input.csv），此时必须显式指定 cwd——幸运的是，VSCode 的 Python 扩展完全支持该能力，且配置方式与调试一致。

✅ 方法一：通过 launch.json 配置运行时工作目录（推荐）

VSCode 的「运行」（Run Python File）功能底层复用调试器配置。只需在项目根目录下创建 .vscode/launch.json（若不存在），添加或修改一个 python 类型的启动配置：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python: Run with custom cwd",
      "type": "python",
      "request": "launch",
      "module": "runpy",
      "args": ["-m", "main"],
      "cwd": "${workspaceFolder}/src",  // ← 关键：指定运行时工作目录
      "console": "integratedTerminal",
      "justMyCode": true
    }
  ]
}

? 说明：

"cwd": "${workspaceFolder}/src" 表示将工作目录设为 workspaceFolder/src；你也可使用绝对路径（如 "C:/myproject/data"）或变量（如 "${fileDirname}" 表示当前文件所在目录）；

"args" 支持传入脚本参数，例如 ["--verbose", "--output", "result.json"]；

使用 Ctrl+Shift+D 打开运行面板 → 选择该配置 → 点击 ▶️ 即可按指定 cwd 运行。

⚠️ 注意：此配置仅影响 VSCode 内部运行（含终端执行），不改变系统全局工作目录，也不影响外部终端直接 python main.py 的行为。

✅ 方法二：代码内固化工作目录（跨环境必备）

当脚本需被他人在任意路径下直接调用（如 python /path/to/main.py），仅靠 VSCode 配置无效。此时应在脚本开头主动切换工作目录至自身所在位置：

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

import os

# 将工作目录设为当前脚本所在目录（推荐）
script_dir = os.path.dirname(os.path.abspath(__file__))
os.chdir(script_dir)
print(f"Working directory set to: {os.getcwd()}")

若脚本还需优先加载同目录下的自定义模块（避免与系统包冲突），可同步调整 sys.path：

import sys
import os

script_dir = os.path.dirname(os.path.abspath(__file__))
os.chdir(script_dir)

# 将脚本目录置于 sys.path 最前，确保本地模块优先导入
if script_dir not in sys.path:
    sys.path.insert(0, script_dir)

✅ 此方案具有强鲁棒性：无论从 VSCode、命令行、IDE 还是自动化任务触发，均能保证路径一致性。

? 总结建议

场景	推荐方案	说明
仅 VSCode 内开发调试	launch.json + cwd	配置灵活、无需改代码，适合迭代阶段
脚本需分发/他人调用	代码内 os.chdir(__file__)	保障可移植性，是生产级最佳实践
混合需求（两者都要）	双管齐下：配置 launch.json + 开头固化路径	兼顾开发效率与部署健壮性