2. 开发环境搭建：Python环境安装、DaVinci Config SDK获取、IDE选择与配置

说实话，很多同学刚开始学脚本自动化，最容易卡住的地方反而不是脚本怎么写，而是环境搭不起来。我见过太多人花了两三天装Python，结果版本不对，SDK路径配错，最后连个hello world都跑不出来。嗯，这一章咱们就把这些坑一个个填平。

2.1 Python环境安装——版本选对，事半功倍

先说说Python。DaVinci Config脚本用的是Python 3，不是Python 2。这个一定要搞清楚。我记得几年前有个学员，照着网上的教程装了Python 2.7，折腾了半天发现SDK根本加载不了，气得直拍桌子。

我的建议是：直接装Python 3.8到3.10之间的版本。为什么？因为DaVinci Config SDK目前对3.11以上的版本支持还不够稳定。我自己一直在用3.9.7，跑了上百个项目，没出过兼容性问题。

下载地址：https://www.python.org/downloads/

安装时记得勾选「Add Python to PATH」——这个选项不勾，后面你会哭的。

安装完成后，打开命令行（Windows按Win+R，输入cmd），敲下面这行命令验证一下：

python --version

如果显示的是 Python 3.9.x 之类的，恭喜你，第一步走通了。如果提示「python不是内部或外部命令」，那就是PATH没配好。别慌，重新运行安装程序，选「Modify」，把PATH勾上就行。

小技巧：我个人习惯用pyenv来管理多个Python版本。如果你以后要同时维护好几个项目，这个工具能帮你省不少事。不过刚开始学，直接装一个稳定版本就够了。

2.2 DaVinci Config SDK获取——别下错地方

SDK这东西，说白了就是DaVinci官方给你的一套工具包。你写脚本的时候，需要调用它里面的函数来操作配置项。

SDK从哪里拿？不是去官网瞎搜，而是藏在DaVinci的安装目录里。我当初第一次找的时候，翻了半天没找到，后来才发现路径是这样的：

C:\Program Files\Blackmagic Design\DaVinci Resolve\Fusion\Modules\DaVinciConfig.py

嗯，注意看，文件名是 DaVinciConfig.py，不是别的。这个文件就是咱们的SDK核心。你把它复制到你的项目目录里，或者直接在脚本里引用它的路径。

避坑指南：我曾经遇到过一个问题——复制SDK文件时，忘了把同目录下的其他依赖文件一起拷过来。结果脚本一跑，报了一堆「ModuleNotFoundError」。所以建议你直接把整个 Modules 文件夹引用到项目里，省心。

引用方式很简单，在脚本开头加这么两行：

import sys
sys.path.append(r"C:\Program Files\Blackmagic Design\DaVinci Resolve\Fusion\Modules")
import DaVinciConfig

这样，你的Python就能找到SDK了。如果你用的是Mac，路径会有点不一样，一般是 /Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Libraries/Fusion/Modules/。Linux用户嘛……嗯，我相信你能自己找到。

2.3 IDE选择与配置——VS Code还是PyCharm？

这个问题，说白了就是「你习惯用刀还是用剑」。两个都能切菜，但手感不一样。

2.3.1 VS Code——轻量、灵活、插件多

我个人更偏爱VS Code。为什么？因为它启动快，插件生态好，而且对Python的支持做得越来越成熟。你想想看，写个脚本还要等IDE加载半天，多影响心情。

配置步骤：

  1. 去 https://code.visualstudio.com/ 下载安装
  2. 安装Python扩展（在扩展商店搜「Python」，选微软官方那个）
  3. 打开设置（Ctrl+,），搜索 python.defaultInterpreterPath，设置成你的Python路径
  4. 创建一个 .vscode/launch.json 文件，配置调试参数

这里给一个我常用的launch.json配置模板：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: 当前文件",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "env": {
                "PYTHONPATH": "${workspaceFolder}"
            }
        }
    ]
}

配置好之后，按F5就能直接跑脚本了。调试的时候可以设断点，一步步看变量变化——这个功能在排查SDK调用问题时特别有用。

2.3.2 PyCharm——重型武器，适合大项目

如果你以后打算做大型的自动化框架，PyCharm会更顺手。它的代码补全、重构、版本控制集成都比VS Code强。但代价就是——吃内存。我16GB的笔记本开PyCharm，再开个DaVinci，风扇就开始转了。

配置要点：

  1. 安装时选「Community Edition」就够了，Professional版对咱们来说有点浪费
  2. 新建项目时，记得选「Existing interpreter」，指向你装好的Python 3.9
  3. 在Settings -> Project -> Project Structure里，把SDK所在的文件夹加进去

我的建议：刚开始学，用VS Code就够了。等你写到第5章、第6章，项目结构复杂了，再考虑换PyCharm。别一开始就把精力花在工具上，脚本本身才是重点。

2.4 验证环境——跑一个测试脚本

环境搭没搭好，跑个脚本就知道了。新建一个 test_env.py，写入以下内容：

import sys
sys.path.append(r"C:\Program Files\Blackmagic Design\DaVinci Resolve\Fusion\Modules")

try:
    import DaVinciConfig
    print("✅ SDK加载成功！版本：", DaVinciConfig.__version__)
except ImportError as e:
    print("❌ SDK加载失败：", e)
    print("请检查路径是否正确")

如果输出是绿色的「✅ SDK加载成功」，那恭喜你，环境搭建全部完成。如果报错，别急，对照下面这个表格排查：

错误信息 可能原因 解决办法
No module named 'DaVinciConfig' 路径不对，或SDK文件没放对位置 检查sys.append里的路径，确认文件存在
SyntaxError: invalid syntax Python版本太低（用了Python 2） 卸载Python 2，安装Python 3.9+
DLL load failed 缺少VC++运行库 安装Visual C++ Redistributable

最后说一句：环境搭建是门手艺活，一次配好后面就顺了。我当年第一次配的时候，折腾了整整一个下午。但配好之后，后面写脚本、调试、部署，一路畅通。所以，别怕麻烦，这一步值得花时间。

好，环境搭好了，下一章咱们就开始写第一个真正的自动化脚本——批量修改时间线设置。到时候你会发现，前面这些折腾都是值得的。

← 上一章 📖 返回目录 下一章 →