1.前置要求操作系统Windows 11其他 Windows 版本亦可CondaMiniconda 或 Anaconda已安装Git用于克隆源码网络连接用于下载依赖2.环境准备2.1创建Conda环境并安装Node.js打开Anaconda Prompt或PowerShell确保conda命令可用执行conda create -n it-tools python3.9 conda activate it-tools conda install nodejs20验证版本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_size4096 vite build如果项目中尚未安装cross-env执行pnpm add -D cross-env。5.2执行构建pnpm build构建成功后会生成dist目录包含所有静态资源。6.运行应用6.1开发模式热重载适合调试pnpm dev访问http://localhost:51736.2预览生产构建pnpm preview默认访问http://localhost:50507.局域网访问本机IP发布7.1修改预览命令监听所有网络接口在package.json的scripts中修改previewpreview: vite preview --host --port 5050或者临时运行不修改文件pnpm preview --host7.2查看本机IPipconfig找到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 foundcross-env未安装执行pnpm add -D cross-envresolveUnref is not exportedvueuse/shared版本冲突升级vueuse/core和vueuse/headpnpm add vueuse/corelatest vueuse/headlatest构建后大文件警告500KB工具本身体积大可忽略不影响功能如需优化可启用代码分割caniuse-lite过时警告Browserslist 数据旧执行npx update-browserslist-dblatestPWA 大文件未预缓存默认缓存大小限制可忽略或调整maximumFileSizeToCacheInBytes配置局域网无法访问防火墙阻止或监听地址未设为0.0.0.0检查防火墙入站规则确保启动命令包含--host9.长期部署建议若需稳定对外服务建议使用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并实现局域网共享。所有警告和错误均有对应解决方案构建产物可直接用于生产环境。运行成功截图如下