设置虚拟环境(Virtual Environment)是 Python 开发的“基操”,你记忆中带 env 的那个内置工具叫 venv。
在项目目录下搞个隔离环境,能有效避免不同项目之间的库版本冲突(比如这个项目要 pandas 1.0,那个要 pandas 2.0)。
以下是快速设置的 3 步走方案:
1. 创建虚拟环境
打开终端(Terminal / CMD),进入你的项目文件夹,运行:
Bash
# 'venv' 是工具名,第二个 'venv' 是你给环境起的文件夹名(通常都叫 venv 或 .venv)
python -m venv venv
运行完后,你会发现文件夹里多了一个叫 venv 的目录。
2. 激活虚拟环境 (最重要的步骤)
创建完后,你必须“进入”这个环境,命令根据操作系统有所不同:
| 操作系统 | 激活命令 (在项目根目录运行) |
|---|---|
| Windows (CMD) | venv\Scripts\activate |
| Windows (PowerShell) | .\venv\Scripts\Activate.ps1 |
| macOS / Linux | source venv/bin/activate |
激活成功的标志: 你的命令行提示符前面会出现 (venv) 的字样。
3. 安装库并开始运行
激活后,你进行的任何 pip install 都只会装在这个小房间里,不会污染系统全局环境。
Bash
# 比如安装我们刚才脚本需要的 pandas
pip install pandas
# 运行你的脚本
python wise_calc.py -f my_data.csv
🛠️ 常用进阶操作
退出环境: 直接输入
deactivate即可回到全局环境。导出依赖清单:
pip freeze > requirements.txt(方便别人一键安装你的环境)。一键恢复环境:
pip install -r requirements.txt。避坑指南: 如果你用 Git,记得在
.gitignore文件里加上venv/,千万别把几百 MB 的环境文件夹传到 GitHub 上。
💡 针对你的 TaxEngine
既然你准备跑 Wise 的脚本,建议操作流程如下:
cd到你的代码目录。python -m venv venv。激活环境。
pip install pandas。跑脚本。
既然环境都搭好了,你是打算直接跑 Wise 的全量数据,还是需要我帮你把 OCBC 的 PDF 转换逻辑也整合进这个虚拟环境里?