VSCode与命令行中Python导入XlsxWriter模块失败求助

问题详情 #

代码示例：

import pandas as pd
import XlsxWriter

# Import excel file
dataframe = pd.read_excel(r'C:\Users\ntanner\Downloads\trial-excel.xlsx',sheet_name = 'Chemical Audit Log')

dataframe2 = pd.read_excel(r'C:\Users\ntanner\Downloads\trial-excel.xlsx',sheet_name = 'Defect Chemical Log')

# display the data frame
dataframe

执行python test.py时报错：

PS C:\Users\MYNAME\Documents\Coding\xlsx practice> python .\test.py
Traceback (most recent call last):
  File "C:\Users\ntanner\Documents\Coding\xlsx practice\test.py", line 3, in <module>
    import xlsxwriter
ModuleNotFoundError: No module named 'xlsxwriter'

已确认信息：

• VSCode切换所有解释器运行，结果与命令行一致
• 多次执行pip install xlsx安装卸载，系统提示模块存在于C:\Python310\Lib\site-packages（版本3.0.3），且目录下确实存在该模块

解决方案 #

1. 修正安装命令 #

你执行的pip install xlsx是错误的，正确的XlsxWriter安装命令为：

pip install XlsxWriter

注意包名是XlsxWriter（大小写敏感，Windows下pip虽不严格区分，但需确保安装的是目标包）。先卸载错误安装的xlsx包：

pip uninstall xlsx

再重新安装正确的包。

2. 匹配pip与python的版本 #

Windows下可能存在多版本Python共存的情况，导致pip安装的包和python命令调用的解释器不匹配：

• 查看当前python对应版本：

python --version

• 查看当前pip对应版本：

pip --version

若两者版本不一致，使用对应版本的pip安装，比如你的Python是3.10，可执行：

pip3.10 install XlsxWriter
# 或直接指定Python路径
C:\Python310\python.exe -m pip install XlsxWriter

3. 检查site-packages路径是否被识别 #

运行以下代码，查看Python当前识别的site-packages目录：

import sys
print(sys.path)

确认C:\Python310\Lib\site-packages是否在输出列表中。如果不在，可手动添加路径：

import sys
sys.path.append(r'C:\Python310\Lib\site-packages')

添加后再尝试导入XlsxWriter。

4. 排查虚拟环境（若使用） #

如果项目使用了虚拟环境，需确认：

• 是否激活虚拟环境后再安装的XlsxWriter
• 运行代码时是否处于正确的虚拟环境中

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