【Python】 Python 项目初始化脚本

脚本用途

• 快速创建一个新的 Python 项目结构

• 自动生成常用目录和文件：

  • src/：源码目录
  • __init__.py：标记 src 为模块
  • main.py：默认程序入口
  • README.md：项目说明文档
  • requirements.txt：依赖列表文件

• 创建并激活虚拟环境 .venv

• 打开新命令行窗口并自动激活虚拟环境

---

使用流程

1. 放置脚本

   • 将批处理文件放到你希望作为项目根目录的文件夹中

2. 运行脚本

   • 双击执行，或在命令行中执行：

     projectInit.bat
     

   • 脚本会检查并创建缺失的目录和文件

3. 虚拟环境

   • 脚本会创建 .venv（如果不存在）
   • 会在新命令行窗口中自动激活 .venv
   • 你可以在该窗口中直接安装依赖和运行程序

4. 文件安全性

   • 已存在的文件和目录不会被覆盖
   • 只会创建缺失的内容
   • 虚拟环境如果已存在，也不会重新创建

---

典型使用场景

• 新建 Python 项目快速搭建初始结构
• 保证项目目录规范化
• 方便虚拟环境管理和依赖隔离
• 可以作为团队统一的项目模板初始化工具

---

使用建议

• 第一次初始化后，可以在 src/ 下写代码或添加模块
• 后续运行脚本只会创建缺失文件，不会破坏已写代码
• 如果希望安全提示，可以改脚本在文件已存在时提示用户

---

源码（projectInit.bat）

@echo off
rem ------------------------------
rem 初始化 Python 项目（单个工程）
rem ------------------------------rem 当前目录作为项目根目录
SET ROOT=%CD%
echo 初始化项目到: %ROOT%rem 1. 创建 src 目录及 __init__.py
if not exist "%ROOT%\src" mkdir "%ROOT%\src"
if not exist "%ROOT%\src\__init__.py" echo # src 模块 > "%ROOT%\src\__init__.py"
echo src/ 目录已创建rem 2. 创建 main.py
if not exist "%ROOT%\main.py" (echo print("Hello, Python Project!") > "%ROOT%\main.py"echo main.py 已创建
)rem 3. 创建 README.md
if not exist "%ROOT%\README.md" (echo # Python Project > "%ROOT%\README.md"echo README.md 已创建
)rem 4. 创建空 requirements.txt
if not exist "%ROOT%\requirements.txt" (echo # 项目依赖列表 > "%ROOT%\requirements.txt"echo requirements.txt 已创建
)rem 5. 创建虚拟环境（.venv）
if not exist "%ROOT%\.venv" (python -m venv .venvecho 虚拟环境 .venv 已创建
)rem 6. 打开新命令行窗口并激活虚拟环境
echo 正在打开命令行并激活虚拟环境...
start cmd /k ".venv\Scripts\activate.bat && cd /d %ROOT%"echo -------------------------------
echo 初始化完成，虚拟环境已激活在新窗口中
pause