使用nbdev_install_quarto安装Quarto报错：无法从os导入uname

报错原因 #

os.uname()是类Unix（Linux/macOS）系统特有的函数，Windows系统的Python标准库os模块中不存在该方法。你遇到的报错是因为nbdev（或其依赖的某个库）的代码未针对Windows环境做兼容处理，直接尝试导入os.uname，而Python 3.12对这类导入错误的提示更严格，最终触发该异常。

解决步骤（优先尝试无需降级的方案） #

1. 升级nbdev到最新版本 #

首先确保你安装的是适配Python 3.12的最新版nbdev，执行以下命令：

pip install --upgrade nbdev

升级完成后，再次尝试运行nbdev_install_quarto，看是否解决问题。

2. 手动安装Quarto（绕开nbdev的安装命令） #

如果升级后仍报错，可以直接手动安装Quarto，无需依赖nbdev_install_quarto：

• 下载对应Windows系统的Quarto安装程序，完成安装
• 将Quarto的安装路径（默认是C:\Program Files\Quarto\bin）添加到系统环境变量PATH中
• 打开新的命令行窗口，执行quarto --version验证，能正常输出版本号即说明安装成功
• 之后继续按照nbdev教程完成后续配置即可

3. 降级Python到3.11版本（备选方案） #

如果上述方法都无法解决，说明nbdev及其依赖暂未完全适配Python 3.12，此时可以考虑降级：

• 卸载当前的Python 3.12（注意备份虚拟环境或已安装的包）
• 安装Python 3.11的Windows版本，安装时务必勾选“Add Python to PATH”选项
• 重新创建虚拟环境，执行pip install nbdev完成安装，再运行nbdev_install_quarto即可正常执行

内容的提问来源于stack exchange，提问作者Reut