Windows系统下新建Python项目的正确步骤及虚拟环境问题解决

三个核心问题解答 #

1. tutorial_env\Scripts\activate的执行位置与时机 #

• 位置：任意文件夹都能执行，只要路径正确。推荐在项目根目录（虚拟环境所在的父目录）打开命令行，后续操作更顺畅。
• 时机：开始项目开发前必须执行，激活后命令行开头会显示(tutorial_env)，所有和该项目相关的pip安装、代码运行、Jupyter启动都要在激活状态下进行。

2. pip install [package name]的执行位置与时机 #

• 位置：必须在虚拟环境已激活的状态下，任意文件夹都能执行（激活后系统会优先使用虚拟环境内的pip）。习惯上在项目根目录执行，方便后续生成依赖清单requirements.txt（执行pip freeze > requirements.txt）。
• 时机：激活虚拟环境后，安装/更新项目依赖时执行。

3. jupyter notebook的执行位置与时机 #

• 位置：同样要在虚拟环境已激活的状态下，推荐在主项目文件夹或项目根目录执行，这样Jupyter默认打开的目录就是你的代码文件所在位置，方便操作。
• 时机：激活虚拟环境后，需要用Jupyter编写/运行代码时执行。首次使用需先安装内核依赖：

  pip install ipykernel
  python -m ipykernel install --user --name=tutorial_env
  

  之后在Jupyter中就能选择tutorial_env内核，避免包找不到的问题。

解决ModuleNotFoundError问题 #

你在Lib文件夹中能看到包但导入失败，核心原因是运行main.py时未激活虚拟环境，或者使用了系统默认的Python解释器。

解决步骤：

1. 先激活tutorial_env虚拟环境
2. 进入主项目文件夹，执行python main.py运行代码（激活后python命令会指向虚拟环境内的解释器）
3. 如果用IDE（如VS Code），需将项目的Python解释器切换为tutorial_env\Scripts\python.exe

专业的项目文件结构 #

规范的项目结构应该将虚拟环境与代码目录分离，示例如下：

your_project_root/          # 项目根目录
├── tutorial_env/           # 虚拟环境目录（建议添加到.gitignore，避免提交到版本库）
├── src/                    # 主项目代码文件夹（可自定义名称，比如main_project）
│   ├── main.py
│   └── ...（其他代码模块）
├── requirements.txt        # 依赖清单（通过`pip freeze > requirements.txt`生成）
└── README.md               # 项目说明文档

正确的创建流程 #

1. 新建项目根目录your_project_root
2. 进入该目录，执行python -m venv tutorial_env创建虚拟环境
3. 激活虚拟环境：tutorial_env\Scripts\activate
4. 安装项目所需依赖：pip install numpy jupyter ipykernel等
5. 生成依赖清单：pip freeze > requirements.txt
6. 在根目录下创建代码文件夹src，编写业务代码
7. 所有开发操作（运行代码、启动Jupyter）都在激活虚拟环境的状态下进行

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