把 Spotify 歌单同步到 YouTube 搬回本地部署，怎么避坑才最稳？
这里分享一套完整的本地部署实操方案，重点在于如何避免污染全局环境以及处理 OAuth 授权。
首先，最忌讳直接在全局环境下 pip install。如果你之前安装过不同版本的库，很容易出现依赖冲突导致脚本报错。建议必须使用虚拟环境（venv）。在终端执行以下命令创建独立空间：mkdir music-sync-tool && cd music-sync-toolpython -m venv venv
如果是 Windows 用户，激活命令是 .\venv\Scripts\activate；Mac 或 Linux 用户则使用 source venv/bin/activate。只有在虚拟环境下，你安装的库才会被限制在这个文件夹内，不会影响系统其他项目。
接下来的依赖安装是核心。这套同步逻辑依赖于 Spotify 的 spotipy 库和 Google 的 API 客户端。执行 pip install spotipy google-api-python-client google-auth-oauthlib 即可。这里有个细节，如果你在安装 google-auth-oauthlib 时遇到 SSL 证书报错，通常是因为本地 Python 环境的证书链没更新，建议检查 Python 版本是否在 3.8 以上。
关于 API Key 的管理，千万不要直接硬编码在 .py 文件里，尤其是如果你在公司环境下开发，代码审计很容易把这种明文密钥标记为风险。最专业的做法是在项目根目录创建一个 .env 配置文件。你需要在这个文件里定义三个关键变量：SPOTIPY_CLIENT_ID（客户端 ID）、SPOTIPY_CLIENT_SECRET（客户端密钥）以及 SPOTIPY_REDIRECT_URI。注意，回调地址必须严格设置为 http://localhost:8888/callback，否则在授权阶段会直接弹出 400 错误，提示 URI 不匹配。
最后进入运行阶段。当你第一次执行主程序时，脚本会通过本地端口启动一个临时的 OAuth 流程，此时会自动弹出浏览器要求你登录 Spotify 和 Google 账号。在点击“同意授权”后，浏览器会跳转到一个 404 页面或空白页，此时不要关闭页面，直接把地址栏里包含 code=xxxx 的完整 URL 复制回终端粘贴即可。一旦本地生成了 .cache 授权文件，后续运行就不再需要手动干预，直到 Token 过期。
在实际向非技术同事推广这套方案时，我发现大家最恐惧的是面对黑色的命令行窗口。为了提高落地效率，我建议写一个简单的 .bat 批处理脚本（Windows 环境），将激活虚拟环境和执行 Python 脚本这两步封装在一起。这样同事们只需要双击一下，就能完成歌单同步，而不需要去理解什么是 venv 或 pip。这种从“配置环境”到“一键运行”的转变，才是本地部署方案能真正跑起来的关键。
