python虚拟环境设置

设置虚拟环境(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 / Linuxsource 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 的脚本,建议操作流程如下:

  1. cd 到你的代码目录。

  2. python -m venv venv

  3. 激活环境。

  4. pip install pandas

  5. 跑脚本。

既然环境都搭好了,你是打算直接跑 Wise 的全量数据,还是需要我帮你把 OCBC 的 PDF 转换逻辑也整合进这个虚拟环境里?