Dify在Windows 11本地部署需严格匹配Python 3.11.x与Node.js 18.20.4版本，否则触发pydantic.v1缺失或OpenSSL不支持等报错；必须通过nvm-windows管理Node版本、新建专用venv并升级pip，再以npm ci精确还原前端依赖，方可通过双环境校验。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Windows 11上启动Dify本地后端时提示“ModuleNotFoundError: No module named 'pydantic.v1'”，前端构建卡在“error:0308010C:digital envelope routines::unsupported”，这类报错本质是Python或Node.js版本与Dify当前分支硬性要求不匹配所致，不是代码问题，而是环境指纹错误。
确认当前Python版本是否符合Dify要求
打开PowerShell，执行：python --version。若输出为Python 3.12.5或Python 3.9.18，则【必须切换】——Dify v0.7.x明确要求Python 3.11.x（如3.11.9），低版本缺typing.TypedDict支持，高版本导致psycopg2-binary等C扩展编译失败。
访问python.org/downloads/release/python-3119/下载Windows x64 MSI安装包，运行时勾选“Add python.exe to PATH”和“Install for all users”（避免权限拦截）。
卸载旧版本前，先用where python查所有python路径，手动删除非3.11.x的python.exe及其所在目录（尤其注意C:\Users\XXX\AppData\Local\Programs\Python\下残留的3.10/3.12文件夹），否则PATH中残留旧路径会导致虚拟环境仍调用错解释器。
立即学习“Python免费学习笔记（深入）”；
隔离Dify专用Python虚拟环境
不要复用全局Python或已有venv。在Dify项目根目录执行：
python -m venv .dify-venv
激活后立即验证解释器真实版本：python -c "import sys; print(sys.version)"，确保输出以3.11.开头。这一步跳过将直接导致后续pip install安装的包与运行时解释器ABI不兼容。
升级pip并指定清华镜像源：python -m pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple。不升级pip可能无法解析pyproject.toml中PEP 621格式的依赖声明。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
定位并清理冲突的Node.js版本
方法一：用nvm-windows精准控制（推荐）
从nvm-windows Releases下载nvm-setup.zip，解压运行安装程序。安装后重启终端，执行nvm list查看已安装版本；若无Node.js 18.x，执行nvm install 18.20.4（Dify v0.7.3经实测最稳版本）；再执行nvm use 18.20.4。
方法二：手动清理多版本残留
检查where node和where npm输出的所有路径，逐个进入对应目录（如C:\Program Files\nodejs\、C:\Users\XXX\AppData\Roaming\npm\），删除除18.20.4外的所有node.exe/npm.cmd文件；清空%APPDATA%\npm-cache目录，否则旧缓存会污染新版本模块解析。
【关键动作】执行npm config delete prefix。很多用户因之前配置过全局prefix，导致npm全局模块装到错误路径，引发command not found类错误。
验证Node.js与Python环境协同有效性
第一步：在已激活的.dify-venv中执行pip install -e ./api（确保后端依赖就绪）。
第二步：切换到web目录，执行npm ci --no-audit（用ci而非install，强制按package-lock.json精确还原，避免next@14.2.5与node 18.20.4间的可选链解析偏差）。
第三步：启动后端服务：cd api && uvicorn app.main:app --reload --host 0.0.0.0 --port 5001，同时新开终端启动前端：cd web && npm run dev。
若浏览器访问http://localhost:3000显示登录页且控制台无红色报错，说明Python与Node.js双环境已通过Dify校验关卡。
