IT-Tools 开源项目本地部署手册（Windows 11 + Conda 环境）
1.前置要求
- 操作系统：Windows 11（其他 Windows 版本亦可）
- Conda（Miniconda 或 Anaconda）已安装
- Git（用于克隆源码）
- 网络连接（用于下载依赖）
2.环境准备
2.1创建Conda环境并安装Node.js
打开Anaconda Prompt或PowerShell（确保conda命令可用），执行：
conda create -n it-tools python=3.9 conda activate it-tools conda install nodejs=20验证版本：
node --version # 应显示 v20.x.x 或更高2.2安装pnpm包管理器
npm install -g pnpm pnpm --version # 验证安装3.获取源码
git clone https://github.com/CorentinTh/it-tools.git cd it-tools4.安装项目依赖
pnpm install可能遇到的对等依赖警告：如出现peer dependency相关警告，可忽略，不影响构建。
5.构建生产版本
项目默认构建脚本在Windows下因环境变量语法问题会报错，需调整。
5.1修复构建脚本（Windows适配）
打开package.json，找到"scripts"中的"build"，将其改为：
"build": "vue-tsc --noEmit && cross-env NODE_OPTIONS=--max_old_space_size=4096 vite build"如果项目中尚未安装cross-env，执行pnpm add -D cross-env。
5.2执行构建
pnpm build构建成功后会生成dist目录，包含所有静态资源。
6.运行应用
6.1开发模式（热重载，适合调试）
pnpm dev访问http://localhost:5173
6.2预览生产构建
pnpm preview默认访问http://localhost:5050
7.局域网访问（本机IP发布）
7.1修改预览命令监听所有网络接口
在package.json的"scripts"中修改"preview"：
"preview": "vite preview --host --port 5050"或者临时运行（不修改文件）：
pnpm preview --host7.2查看本机IP
ipconfig找到IPv4地址（例如192.168.1.100）。
7.3防火墙放行端口
- 打开控制面板→Windows Defender防火墙→高级设置
- 点击入站规则→新建规则
- 选择端口→TCP→ 特定本地端口填5050
- 允许连接 → 勾选所有配置文件 → 命名完成
7.4局域网访问
其他设备浏览器访问http://<本机IP>:5050（如http://192.168.1.100:5050）。
8.常见问题与解决方案
问题现象 | 原因 | 解决方法 |
'NODE_OPTIONS'不是内部或外部命令 | Windows 不支持 Linux 环境变量语法 | 使用cross-env或手动设置set NODE_OPTIONS=... |
cross-env: command not found | cross-env未安装 | 执行pnpm add -D cross-env |
"resolveUnref" is not exported | @vueuse/shared版本冲突 | 升级@vueuse/core和@vueuse/head：pnpm add @vueuse/core@latest @vueuse/head@latest |
构建后大文件警告（>500KB） | 工具本身体积大 | 可忽略，不影响功能；如需优化可启用代码分割 |
caniuse-lite过时警告 | Browserslist 数据旧 | 执行npx update-browserslist-db@latest |
PWA 大文件未预缓存 | 默认缓存大小限制 | 可忽略；或调整maximumFileSizeToCacheInBytes配置 |
局域网无法访问 | 防火墙阻止或监听地址未设为0.0.0.0 | 检查防火墙入站规则，确保启动命令包含--host |
9.长期部署建议
若需稳定对外服务，建议使用Nginx、Caddy等Web服务器托管dist目录，或使用serve工具：
npx serve -s dist -l 5050 --host也可以使用Docker一键部署（官方提供）：
docker run -d --name it-tools --restart unless-stopped -p 8080:80 corentinth/it-tools:latest10.总结
遵循以上步骤，你可以在Windows 11 + Conda环境下成功本地部署IT-Tools，并实现局域网共享。所有警告和错误均有对应解决方案，构建产物可直接用于生产环境。
运行成功截图如下：