面对全英文文献和复杂的环境配置，科研新手常感头疼。pdf2zh插件能实现Zotero内保留排版的对照翻译，但其配置门槛不低。本指南提供从零开始的完整配置流程，帮助用户轻松搭建环境，解决文献阅读难题。
智能速览
利用Anaconda创建独立的Python虚拟环境，避免冲突。
通过清华镜像源可显著提升国内下载依赖包的速度。
在VSCode中关联虚拟环境，运行翻译服务端程序。
Zotero内右键即可启动翻译，生成双语对照文档。
翻译结果能完美保留原文的排版、公式与图表。
精华内容
配置pdf2zh插件的核心在于搭建并运行一个本地翻译服务，过程涉及环境管理、代码执行与软件联动，下面将分步详解。
环境准备
首先需要安装Anaconda，它用于管理独立的Python环境，避免不同项目间的包版本冲突。推荐从清华镜像源下载，速度更快。安装时务必选择“Just Me”选项，并将路径设置为全英文且不含空格，例如D盘，以防后续程序报错。
创建环境
安装完成后，打开Anaconda Prompt终端。执行命令 `conda create -n pdf2zh python=3.12` 即可创建一个名为pdf2zh的虚拟环境。随后通过命令 `conda activate pdf2zh` 激活该环境，激活后终端提示符前会出现 `(pdf2zh)` 字样，表示环境切换成功。
配置VSCode
VSCode作为代码编辑器，是运行翻译服务的关键。从官网下载并安装后，需在插件市场中搜索并安装中文语言包、Python和Jupyter插件。这些插件能让VSCode识别Python代码，并连接到刚才创建的pdf2zh虚拟环境。
启动服务
从pdf2zh官方仓库下载或克隆项目代码到本地，并用VSCode打开。在VSCode右下角点击选择Python解释器，确保选中了之前创建的 `pdf2zh` 环境。然后打开终端，执行 `pip install -r requirements.txt` 安装所需依赖，最后运行 `python server.py` 启动翻译服务。
Zotero内翻译
确保Zotero已安装pdf2zh插件，且本地的翻译服务正在运行。在Zotero中任意选择一篇PDF文献，右键点击选择“PDF2ZH翻译”。稍等片刻，即可生成两个新文件：一个是与原文逐句对照的双语版本，另一个是翻译后的完整版本，两者都完美保留了原始排版、公式和图表。
掌握pdf2zh的配置流程，相当于拥有了一个高效的个人文献翻译助手，极大提升阅读效率。这套方法虽然步骤稍多，但一劳永逸。未来是否会有更便捷的集成方案出现？
关键评论
有用户反馈在最后翻译步骤时遇到“处理单个文件失败”的弹窗，提示需注意服务端启动状态或文件特殊性。
