IT-Tools 开源项目本地部署手册（Windows 11 + Conda 环境）-三亩地-编程学习日记

1.前置要求

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-tools

4.安装项目依赖

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 --host

7.2查看本机IP

ipconfig

找到IPv4地址（例如192.168.1.100）。

7.3防火墙放行端口

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:latest

10.总结

遵循以上步骤，你可以在Windows 11 + Conda环境下成功本地部署IT-Tools，并实现局域网共享。所有警告和错误均有对应解决方案，构建产物可直接用于生产环境。

运行成功截图如下：

日记详情