项目概述
本文将详细介绍一个主要是为了解决AI Studio生成的Node.js程序的存放文件夹并快速生成问题的工具软件。功能有:文件夹结构的创建、浏览、文件内容的查看与编辑等功能,适合作为文件管理工具或项目结构生成器使用。
运行结果

功能特性
核心功能
文件夹选择与浏览:可视化选择目标文件夹结构化创建:根据文本描述批量创建文件夹和文件树形展示:以树形结构展示目录层级文件编辑:支持文件内容的查看与编辑备注管理:提供备注列表功能,支持剪贴板操作配置持久化:自动保存和恢复用户配置技术架构
使用的技术栈
Python 3.xwxPython:GUI框架标准库:os, re, json, subprocess, platform程序结构
FileManagerFrame (主窗口类)
├── 界面初始化
├── 事件处理方法
├── 文件操作方法
└── 配置管理方法
代码详解
1. 类初始化与界面布局
class FileManagerFrame(wx.Frame):
def __init__(self):
super().__init__(parent=None, title='文件管理器', size=(1200, 800))
设计思路:
使用双面板布局(左右分栏)左侧:文件夹操作、结构输入、树形展示、备注列表右侧:文件内容编辑区关键组件:
# 主要的UI组件 self.folder_text # 显示目标文件夹路径 self.memo1 # 输入文件夹结构 self.tree_ctrl # 树形控件,展示目录结构 self.memo2 # 文件内容编辑器 self.listbox1 # 备注列表 self.edit1 # 备注输入框
2. 文件夹选择功能
def on_select_folder(self, event):
dlg = wx.DirDialog(self, "选择目标文件夹", style=wx.DD_DEFAULT_STYLE)
if dlg.ShowModal() == wx.ID_OK:
self.target_folder = dlg.GetPath()
self.folder_text.SetValue(self.target_folder)
dlg.Destroy()
技术要点:
使用wx.DirDialog 提供原生的文件夹选择对话框选择后不立即加载树形结构,避免大文件夹导致卡顿通过 dlg.Destroy() 手动释放对话框资源
3. 文件夹结构解析算法
这是程序的核心算法之一,用于解析树形文本结构:
def parse_folder_structure(self, structure_text):
lines = structure_text.strip().split('\n')
structure = []
root_name = None
for i, line in enumerate(lines):
# 移除树形字符 (│├└─)
clean_line = re.sub(r'^[│├└─\s]+', '', line).strip()
# 提取名称(去掉注释)
name = clean_line.split('(')[0].strip()
is_folder = name.endswith('/')
name = name.rstrip('/')
if i == 0:
root_name = name
structure.append({
'name': name,
'is_folder': True,
'level': 0
})
else:
# 计算层级(通过树形字符数量)
tree_chars = len(line) - len(line.lstrip('│├└─ \t'))
level = tree_chars // 4 + 1 # 每4个字符一个层级
structure.append({
'name': name,
'is_folder': is_folder,
'level': level
})
return structure, root_name
算法解析:
1.正则表达式清理:
r'^[│├└─\s]+' 匹配行首的树形字符去除这些字符后得到纯粹的文件/文件夹名
2.层级计算:
通过计算树形字符的数量来确定层级每4个字符代表一个缩进层级例:├── file.txt 的层级为 1
3.文件夹识别:
以/ 结尾的视为文件夹其他视为文件
4.注释处理:
支持在名称后添加括号注释如:server.js (后端入口)
4. 文件系统创建算法
def create_from_structure(self, structure, base_path):
path_stack = [base_path] # 使用栈维护当前路径
for i, item in enumerate(structure):
name = item['name']
is_folder = item['is_folder']
level = item['level']
if i == 0:
continue # 跳过根节点
# 根据层级调整路径栈
while len(path_stack) > level:
path_stack.pop()
# 构建当前路径
current_path = os.path.join(path_stack[-1], name)
if is_folder:
os.makedirs(current_path, exist_ok=True)
path_stack.append(current_path) # 文件夹入栈
else:
# 创建文件
parent_dir = os.path.dirname(current_path)
if parent_dir:
os.makedirs(parent_dir, exist_ok=True)
with open(current_path, 'w', encoding='utf-8') as f:
pass # 创建空文件
数据结构:路径栈
路径栈是这个算法的关键:
作用:维护当前所在的文件夹路径
操作:
遇到文件夹:入栈层级减小:出栈到对应层级示例:
my-project/ level=0 栈:[base_path]
├── src/ level=1 栈:[base_path, src]
│ └── main.js level=2 栈:[base_path, src]
└── public/ level=1 栈:[base_path, public] (src出栈)
└── index.html level=2 栈:[base_path, public]
5. 树形控件填充
def populate_tree(self, parent_item, path, depth=0, max_depth=10):
if depth >= max_depth:
return # 防止递归过深
try:
items = sorted(os.listdir(path))
folders = []
files = []
# 分类文件和文件夹
for item in items:
if len(item) > 0 and item[0] == '.':
continue # 跳过隐藏文件
if len(item) > 0 and item[0] == '$':
continue # 跳过系统文件
item_path = os.path.join(path, item)
try:
if os.path.isdir(item_path):
folders.append((item, item_path))
else:
files.append((item, item_path))
except (PermissionError, OSError):
continue
# 先显示文件夹
for item_name, item_path in folders:
display_name = '[DIR] ' + item_name
child = self.tree_ctrl.AppendItem(parent_item, display_name)
self.tree_ctrl.SetItemData(child, item_path)
self.populate_tree(child, item_path, depth + 1, max_depth)
# 再显示文件
for item_name, item_path in files:
display_name = '[FILE] ' + item_name
child = self.tree_ctrl.AppendItem(parent_item, display_name)
self.tree_ctrl.SetItemData(child, item_path)
except (PermissionError, OSError):
pass
设计亮点:
深度限制:max_depth=10 防止目录层级过深导致性能问题分类显示:文件夹优先显示,便于浏览数据关联:使用 SetItemData 将完整路径与树节点关联异常处理:优雅处理权限错误
6. 文件内容读写
def load_file_content(self, file_path):
"""加载文件内容 - 支持多种编码"""
try:
with open(file_path, 'r', encoding='utf-8') as f:
content = f.read()
self.memo2.SetValue(content)
except Exception:
try:
# 尝试GBK编码(兼容中文Windows)
with open(file_path, 'r', encoding='gbk') as f:
content = f.read()
self.memo2.SetValue(content)
except Exception as e:
self.memo2.SetValue('无法读取文件内容: ' + str(e))
def on_save_file(self, event):
"""保存文件内容"""
if not self.current_file:
wx.MessageBox('请先选择一个文件', '提示', wx.OK | wx.ICON_INFORMATION)
return
try:
content = self.memo2.GetValue()
with open(self.current_file, 'w', encoding='utf-8') as f:
f.write(content)
wx.MessageBox('保存成功!', '提示', wx.OK | wx.ICON_INFORMATION)
except Exception as e:
wx.MessageBox('保存失败: ' + str(e), '错误', wx.OK | wx.ICON_ERROR)
编码兼容性处理:
优先尝试UTF-8编码失败后尝试GBK编码(兼容旧版Windows中文文件)最后显示错误信息7. 配置持久化
def save_config(self):
"""保存配置到JSON文件"""
config = {
'target_folder': self.target_folder,
'listbox_items': [self.listbox1.GetString(i)
for i in range(self.listbox1.GetCount())]
}
try:
with open(self.config_file, 'w', encoding='utf-8') as f:
json.dump(config, f, ensure_ascii=False, indent=2)
except Exception as e:
print('保存配置失败: ' + str(e))
def load_config(self):
"""程序启动时加载配置"""
if os.path.exists(self.config_file):
try:
with open(self.config_file, 'r', encoding='utf-8') as f:
config = json.load(f)
self.target_folder = config.get('target_folder', '')
self.folder_text.SetValue(self.target_folder)
listbox_items = config.get('listbox_items', [])
for item in listbox_items:
self.listbox1.Append(item)
except Exception as e:
print('加载配置失败: ' + str(e))
配置项:
目标文件夹路径备注列表内容优势:
使用JSON格式,易读易维护ensure_ascii=False 保证中文正确保存程序重启后自动恢复上次状态
8. 系统集成功能
def on_open_folder(self, event):
"""调用系统文件管理器打开文件夹"""
if not self.target_folder or not os.path.exists(self.target_folder):
wx.MessageBox('请先选择有效的目标文件夹', '提示', wx.OK | wx.ICON_INFORMATION)
return
try:
if platform.system() == 'Windows':
os.startfile(self.target_folder)
elif platform.system() == 'Darwin': # macOS
subprocess.Popen(['open', self.target_folder])
else: # Linux
subprocess.Popen(['xdg-open', self.target_folder])
except Exception as e:
wx.MessageBox('打开文件夹失败: ' + str(e), '错误', wx.OK | wx.ICON_ERROR)
跨平台兼容性:
Windows:使用os.startfile()macOS:调用 open 命令Linux:调用 xdg-open 命令
使用场景
1. 项目模板生成
快速创建标准项目结构:
my-project/
├── src/
│ ├── main.js
│ └── utils.js
├── public/
│ └── index.html
├── package.json
└── README.md
2. 批量文件管理
浏览大型项目目录快速定位和编辑文件查看文件内容而不离开程序3. 文档整理
创建文档目录结构统一管理项目文档记录备注信息性能优化
1. 延迟加载
wx.CallAfter(self.refresh_tree) # 异步刷新,避免阻塞
2. 深度限制
max_depth=10 # 限制递归深度
3. 过滤系统文件
if item[0] == '.' or item[0] == '$':
continue # 跳过不必要的文件
潜在改进方向
1. 功能增强
支持文件搜索功能添加文件拖拽功能支持多文件批量编辑增加文件预览(图片、PDF等)添加文件对比功能2. 用户体验
添加快捷键支持支持主题切换添加最近打开列表支持书签功能增加操作历史记录3. 性能优化
虚拟树(大目录优化)文件内容缓存多线程加载增量更新树节点4. 扩展功能
支持Git集成添加文本比较工具支持正则表达式搜索添加代码高亮显示支持插件系统常见问题与解决方案
Q1: 中文乱码问题
解决:使用多编码尝试机制,优先UTF-8,备选GBK
Q2: 大文件夹加载慢
解决:
延迟加载,不自动刷新限制递归深度跳过隐藏文件Q3: 树节点展开报错
解决:移除 wx.TR_HIDE_ROOT 样式,显示根节点
Q4: 配置文件损坏
解决:使用 try-except 包裹配置加载,失败时使用默认值
到此这篇关于使用python快速生成nodejs项目文件结构的文章就介绍到这了,更多相关python生成项目文件结构内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持!
