1.antvԴ?源码?
2.@antv/x6、@antv/x6-react-components X6 图编辑引擎在 react typescript 项目中实践
3.Vue3 + Three.js + antvG2 实战智慧城市
4.从零开始学G6
5.一次vue-cli4项目升级到vite的源码经历

antvԴ??

       地图开发领域中，开源项目提供了丰富的源码资源和工具，以下是源码一些具有代表性的项目，它们在不同方面展现出其独特价值。源码

       Historical-Atlas

       这个项目以其直接的源码源码商务系统命名“历史地图集”吸引了众多关注，作者采用的源码AGPL-3.0开源协议使得它不仅适合作为参考设计思路或在线服务提供，也鼓励其作为软件产品对外分发时保持开源状态。源码项目中存在一些遗留问题，源码如数据库配置和用户信息存储的源码实现，但通过对照源码，源码还原表结构并不困难。源码

       vue3-ts-cesium-map-show

       由地虎降天龙开发的源码这个项目，采用MIT开源许可协议，源码是源码一个专注于三维可视化数字城市应用，结合Cesium-1.开源库，提供后台可视化编辑与保存功能。

       QGIS

       作为开源地理信息系统，QGIS支持Windows、Linux、MacOS，拥有强大的地理空间管理与分析能力，包括时间动画、3D地图预览和地图美化等特性，使用户能够生成美观的地图。

       react-baidu-map

       由uiw开发的react-baidu-map项目，基于React封装了百度地图组件，简化了将地图集成到React项目的过程，使开发者能够快速接入地图功能。

       Maptalks

       Maptalks是一个HTML5地图引擎，基于原生ES6 Javascript开发，提供二三维一体化地图能力，通过二维地图旋转、倾斜增加三维视角，并支持插件化设计。

       QuickEarth-Free

       QuickEarth（QE）是一个面向个人免费开放的二三维一体化Web端矢量和栅格数据渲染引擎，适用于气象、海洋、水文、环境等领域，帮助用户实现数据可视化。

       地图下载器

       使用Java开发的jquery实例源码地图瓦片图下载工具，支持多种地图服务，如OpenStreetMap、天地图、谷歌地图等，提供XYZ瓦片图下载与合并功能，方便用户获取地图数据。

       L7

       L7是蚂蚁金服AntV推出的一款基于WebGL的开源大规模地理空间数据可视分析框架，专注于数据可视化表达，通过多种视觉变量设置实现信息的有效呈现，满足地图图表、BI系统可视化分析、GIS等领域的需求。

       xdh-map

       xdh-map是一款基于Openlayers的地图应用Vue组件，内置多种地图瓦片，并支持与多个PGIS厂商对接，提供丰富的组件，如文本、图形、热力图等，以及与ECharts结合实现基于地理位置的图表，满足项目常见需求。

       这些开源项目在地图开发领域中各具特色，为开发者提供了丰富的选择和强大的技术支持。

@antv/x6、@antv/x6-react-components X6 图编辑引擎在 react typescript 项目中实践

       X6是AntV推出的图编辑引擎，具备丰富的交互组件与便捷的节点定制能力，旨在快速构建DAG图、ER图、流程图等应用。

       通过X6，开发者可以轻松搭建出功能丰富的图形界面，实现节点的拖拽、连线、缩放等操作，极大地提高了应用开发的效率和用户体验。

       具体文档可访问：x6.antv.vision/zh/docs...

       欲深入了解X6的源码实现与实践案例，可参阅此详细GitHub链接：/tangweiwei/vue-antvx6-app

       在实践项目中，X6凭借其强大的图编辑功能与易用的API设计，为开发者提供了一个高效、灵活的图形应用构建平台，极大地丰富了React TypeScript项目在图形展示与交互设计方面的溯源码健康可能性。

       通过将X6与React TypeScript结合使用，可以实现高度定制化的图形界面，满足复杂业务场景的需求，提供直观、交互性强的用户界面体验。

       总之，X6为开发者提供了一个功能强大、易于集成的图编辑引擎，极大地简化了图形应用的开发流程，为React TypeScript项目带来了更多可能性。

Vue3 + Three.js + antvG2 实战智慧城市

       本文旨在为有兴趣学习 Three.js 的开发者提供一个免费的实践指南，具体实作了一个基于 Vue3、Vite、TypeScript、Three.js 和 antv G2 的智慧城市项目 demo。由于模型资源的限制，部分细节可能不够精细或美观，请谅解。

       项目技术栈包括 Vue3、Vite、TypeScript、Three.js、antv G2，所有源码公开，供学习使用。

       以下是开发流程概览：

       1. **初始化**：引入 Three.js，初始化场景、相机、渲染器、光线、轨道控制器，并打印以确认环境设置。

       2. **搭建场景**：加载模型和天空盒子，展示基本场景。

       3. **文字显示**：使用 canvas 写入文字，转为，作为纹理导入 Three.js，实现文字显示。

       4. **交互设计**：通过监听鼠标事件，实现点击触发文字事件。

       5. **动态效果**：制作动态光圈，站长源码交流通过动画方法控制几何体（光圈）的移动。

       6. **图表与样式**：整合图表和页面样式，搭建最终界面。

       为了实现这些功能，推荐在项目结构中创建相应的文件夹和组件，并确保资源（如）位于适当的位置。

       最终，本项目提供了一个从基础到进阶的 Three.js 实践案例，适合前端开发者深入了解 3D 技术在 Web 开发中的应用。

       项目源码链接：[项目源码链接]

从零开始学G6

       本文旨在帮助读者从零开始理解G6，一个强大的图可视化引擎。通过阅读，你将对G6的功能分布、主要流程有基本的认识，而不涉及具体API的使用。

       G6是antv体系中的图形库，专长于关系图的绘制。它是一个开源的JavaScript库，支持PC、移动端和小程序等平台，通过G提供渲染能力，G是一款强大的跨平台渲染引擎，支持canvas和svg。

       工程结构方面，G6采用monorepo管理模式，使用lerna管理子项目。构建G6，只需运行`npm install`和`npm run bootstrap`。其功能分布清晰，官方v4框架图展示了基础功能的布局。

       核心流程包括创建graph实例，初始化必要的单例，构建Group树结构，然后交给G进行渲染。G6的绘制流程涉及节点数据的输入、处理和渲染。节点的组织则是通过itemController创建Item实例来实现的。

       除了绘制，G6还支持交互、事件、状态管理、b超源码动画和布局等功能。事件处理有清晰的分类，包括canvas、节点和时机相关事件。动画是利用G的内置能力，布局则使用来自外部npm包的算法。

       总结起来，G6的功能层次分明，每个功能都有其特定的职责和执行流程。通过本文的梳理，你应该对G6的整体架构和工作原理有了更深入的理解。如果你对源码感兴趣，可以进一步探索。最后，想了解更多动态，可以关注微信公众号Eval Studio。

一次vue-cli4项目升级到vite的经历

       背景

       使用vue-cli4的项目，业务写多了之后开发运行和打包都慢了很多，为了提升开发体验以及更新团队技术框架，需要升级到更高级的脚手架上，两种方案：一是升级到vue-cli5，二是升级到最新的vite。

       其中第一种方案升级简单，经过实验，打包的速度不升反慢，这可能和项目中的有依赖以及业务代码有关。

       第二种方案升级vite，经过可行性调查，升级到vite的成功率非常高，最后决定从vue-cli4升级到vite，这是一个高风险高回报的事情，因为尽管市面上已存在很多升级成功的案列，但是每个项目都不一样，我们的项目也很庞大，依赖很多，并没有%升级成功的把握。而升级成功的回报也很显而易见，开发环境几乎秒运行，开发体验得到了显著提升。

升级前后对比

       ||vue-cli4|vite||---|---|---||开发启动时间|ms|ms||生产打包时间|s|s||打包体积|.6MB|.6MB||运行期间同一代码改动编译时间|ms|瞬时|

       生产环境打包时间可能和我们项目中用到了太多vite插件有关系，但开发环境的提升非常显著。

项目状况

       项目中用到的Vue2，VueCli版本：4.5.，版本更新时间为.5.8，vueCli4的最后版本为4.5.(.3.)，依赖的webpack版本为^4.0.0

       组件库使用vant，依赖Less预处理器，通过vue.config.js配置设置了less主题色，在webpack仅支持less-loader@5版本以及对应的less版本

       业务css预处理器为stylus:"^0..5"，对应stylus-loader:"^3.0.2"

       进行了多页打包（MPA）

       使用了workbox-webpack-plugin插件配置了PWA：WorkboxWebpackPlugin

       配置了多个路径映射（alias别名）

       指定了文件输出路径以及hash配置

       生产环境下关闭productionSourceMap以及css的sourceMap提升打包速度

       proxy开启多个代理

       用到了.env文件中的环境变量

       按照开发规范忽略部分文件后缀以及index.js

       移除了preload脚本

期望结果

       可以使用vite进行开发和打包

       仍保留webpack打包功能（因为项目太大，不能保证升级到vite后会不会有问题，所以仍希望webpack原本功能正常运行）

准备工作

       升级Node版本，vite只支持node及以上，建议升级到v以上。

       安装pnpm工具，pnpm作为更好的npm依赖管理工具，是目前npm和yarn的最好替代品，且有些依赖包使用npm安装时会有异常，使用pnpm安装可解决：pnpm

       小项目尝试一键转换升级：wp2vite、webpack-to-vite，这两个工具都提供了一键将webpack项目转成vite的能力，但对于大中型项目，并不可靠。

开始行动1.安装必要依赖pnpm?add?vite-plugin-env-compatible?vite-plugin-html?vite?vite-plugin-vue2?--dev

       vite-plugin-vue2是处理vue2版本代码的插件，如果项目中是vue3，安装的依赖有所不同，请参考webpack-to-vite

2.复制html到根目录，并修改 注意是复制，并只改动复制后的html，这样才不会破坏原有webpack功能。

       修改复制后的html，增加对应的js文件引用，注意type属性不能少！

<!--?忽略一些代码?--><body><div?id="app"></div>++?<script?type="module"?src="/src/main.js"></script>?++</body>

       多页打包(MPA)，其他页面的html同样操作，不同html引入对应的js即可。

3.新增vite.config.js文件，开始迁移最重要的配置部分

       空配置如下：

import?{ ?defineConfig?}?from?'vite'export?default?defineConfig({ })4.修改环境变量

       环境变量主要面临两个问题：

       要兼容webpack和vite的环境变量用法

       解决方法：使用vite插件vite-plugin-env-compatible，让vite中可以使用webpack中读取环境变量的方式，再配合envPrefix配置，让vite可以读取到VUE_APP_开头的环境变量：

?pnpm?add?vite-plugin-env-compatible?-D?import?{ ?defineConfig?}?from?'vite'?import?envCompatible?from?'vite-plugin-env-compatible'?export?default?defineConfig({ plugins:?[?envCompatible()],envPrefix:?['VUE_APP_']?//?很重要?})?//?mian.js测试?console.log(process.env.VUE_APP_UNION_STATS)?console.log(import.meta.env.VUE_APP_UNION_STATS)

       两个打印都得到了正确的结果，注意：vite中默认只能读取到VITE_开头的环境变量，如果不配置envPrefix，则会导致第二个打印为undefind。

       vite.config.js中不能读取到环境变量

       vite.config.js是无法直接通过import.meta.env和process.env获取环境变量的，我们需要通过vite的loadEnv获取。

       我们需要将vite.config.js的导出对象改为函数：

?import?{ ?defineConfig,loadEnv?}?from?'vite'?export?default?({ ?mode?})?=>?{ ?const?isPro?=?mode?===?'production'?//?我们可以通过mode直接判断当前是不是生产环境，注意mode可以在运行指令中指定：`vite?build?--mode?master`，如果没有指定，那默认打包就是production?function?getEnv(key)?{ ?//?定义获取环境变量的方法?return?loadEnv(mode,?process.cwd(),'')[key]?//?第三个参数非常重要，下面有详解?}?return?defineConfig({ ?base:?getEnv('VUE_APP_PUBLICPATH'),?//?读取环境变量?//?...忽略其他代码?})?})

       loadEnv有三个参数，前两个参数基本固定不变，而第三个参数默认情况下是不需要传的，只有在配置了envPrefix项，读取非VITE_开头的变量时才需要，在loadEnv源码中我们可以看到，第三个参数是prefixes:string|string[]='VITE_'，也就是环境变量的前缀，默认是VITE_。

       如果你的项目和我一样，读取了VUE_APP_PUBLICPATH这样非VITE_开头环境变量，就在loadEnv的第三个参数传递空字符串即可，这样就能读取到所有的环境变量了。

5.兼容commonjs代码

       项目中有用到commonjs规范的依赖，比如letmd5=require('js-md5').create()，webpack是基于node开发的，支持require语法，在打包的时候webpack也会正确处理这部分代码，但在vite中不会，所以需要将这部分代码改成importmd5from'js-md5'

       项目开发环境下，一些node_modules中的包也会存在commonjs的代码，我们可以通过vite的插件?vite-plugin-commonjs来实现这部分代码的转化，保证开发环境的正常运行。

pnpm?add?@originjs/vite-plugin-commonjs?--dev//?vite.config.js?忽略其他代码import?{ ?viteCommonjs?}?from?'@originjs/vite-plugin-commonjs'export?default?({ ?mode?})?=>?{ return?defineConfig({ plugins:?[//?...viteCommonjs()?//?兼容vite中的cjs导入语法]})})6.解决css预处理的问题

       vite内置了对主流css预处理器的支持（sass/less/stylus），项目使用预处理器时，只需要安装对应预处理依赖即可：

#?.scss?and?.sasspnpm?add?sass?-D#?.lesspnpm?add?stylus?-D#?.styl?and?.styluspnpm?add?stylus?-D

       比较巧的是，我们项目中用到的Stylus的@import别名的语法和vite冲突，@import'~@/public/stylus/mixins'这样的代码是会报错，一开始我找到了插件，可以帮助我们解决这个问题：vite-plugin-stylus-alias，但是都后面打包的时候发现这个插件有副作用，后面采取了其他方法解决。

<!--?忽略一些代码?--><body><div?id="app"></div>++?<script?type="module"?src="/src/main.js"></script>?++</body>0<!--?忽略一些代码?--><body><div?id="app"></div>++?<script?type="module"?src="/src/main.js"></script>?++</body>1

       使用这个插件会导致无法生成sourcemap文件，在打包的时候可以看到警告：Sourcemapislikelytobeincorrect:aplugin(vite-plugin-stylus-alias)wasusedtotransformfiles,butdidn'tgenerateasourcemapforthetransformation.Consulttheplugindocumentationforhelp，鉴于插件作者已经很久没有更新，建议能改成相对路径还是直接改，如果引用地方较多，可以定义文件为全局styl文件最新解决方案：一般出现这个报错是因为插件使用了vite的transformapi转换代码，但是return值缺失导致，解决方法：复制插件代码到项目中，在插件transform函数return的结果中，返回map:null，然后再vite.config.js中引用项目中修改后的插件，即可完美解决，如下：文末解决bug有细说

<!--?忽略一些代码?--><body><div?id="app"></div>++?<script?type="module"?src="/src/main.js"></script>?++</body>2

       定义stylus全局文件

<!--?忽略一些代码?--><body><div?id="app"></div>++?<script?type="module"?src="/src/main.js"></script>?++</body>3

       这里需要注意，官方文档中css-preprocessoroptions写的是使用文件名拓展名作为key，stylus的文件拓展名是styl，但是我使用了stylus作为key并不会有问题，相反使用styl作为key则不生效了，后续这个地方可以留意一下。

       在vite源码中，stylus和styl都进行了判断，理论上都可以使用，但目前测试的结果就是styl作为key不生效，可能源码中其他地方还能找到原因。

7.组件库按需导入和定制主题

       我们项目中用到的组件库是Vant2，该组件库依赖Less，以及通过配置文件来定制组件的主题，在配置中我们需要进行修改：

       vue-cli中的主题配置部分如下：

<!--?忽略一些代码?--><body><div?id="app"></div>++?<script?type="module"?src="/src/main.js"></script>?++</body>4

       vite中主题配置部分如下：

<!--?忽略一些代码?--><body><div?id="app"></div>++?<script?type="module"?src="/src/main.js"></script>?++</body>5

       按需导入项目中按需导入vant组件库，组件可以成功导入，但是组件的样式缺失了，这是因为在webpack中，babel-plugin-import插件帮我们实现了组件的样式导入，在vite中使用?vite-plugin-style-import插件帮我们实现这个功能，不仅vant组件库，其他诸如element、antv等组件库也可以使用这个插件进行按需导入：

<!--?忽略一些代码?--><body><div?id="app"></div>++?<script?type="module"?src="/src/main.js"></script>?++</body>6<!--?忽略一些代码?--><body><div?id="app"></div>++?<script?type="module"?src="/src/main.js"></script>?++</body>.修改alias别名配置，以及忽略文件后缀

       vite配置别名的方法和vue-cli有所不同，且没有默认的别名，都需要通过配置实现，且vite默认不能忽略文件后缀导入，我们也需要通过修改配置来实现：

<!--?忽略一些代码?--><body><div?id="app"></div>++?<script?type="module"?src="/src/main.js"></script>?++</body>8

       需要注意extensions配置的顺序，从左到右进行匹配，如果存在同名但类型不同的文件，很可能得到期望外的结果，比如同目录下存在index.js和index.vue，按上面的顺序，import'./index?会优先匹配到index.js文件。这种情况建议补全后缀进行导入。

9.配置前端跨域

       vite配置跨域和webpack也有出入，需要修改配置

<!--?忽略一些代码?--><body><div?id="app"></div>++?<script?type="module"?src="/src/main.js"></script>?++</body>9

       以上就是几种常见的跨域配置方式，webpack中的devServer改为了server,webpack的proxy中的pathRewrite改成了rewrite，并且类型成为了函数，在函数中返回请求的路径即可。

.多页打包以及打包的其他配置

       vite在build.rollupOptions配置多页打包，参考rollupOptions，其他配置参考文档

import?{ ?defineConfig?}?from?'vite'export?default?defineConfig({ }).配置运行路径

       base是指项目运行在服务器的哪个路径下，一般通过从环境变量中动态获取。

import?{ ?defineConfig?}?from?'vite'export?default?defineConfig({ }).配置EsLint

       vite中使用vite-plugin-eslint插件实现eslint的检查功能，安装过程中发现vite-plugin-eslint@1.4.0会报错，安装1.3.0版本即可。

import?{ ?defineConfig?}?from?'vite'export?default?defineConfig({ })2import?{ ?defineConfig?}?from?'vite'export?default?defineConfig({ }).使用插件@vitejs/plugin-legacy兼容低版本浏览器

       plugin-legacy文档

import?{ ?defineConfig?}?from?'vite'export?default?defineConfig({ }).配置运行指令import?{ ?defineConfig?}?from?'vite'export?default?defineConfig({ })5

       可以在指令中声明mode环境，这个mode在vite.config.js中可以得到，具体可以参考前面4.修改环境变量

       保存运行指令npmrunserve开发环境已经可以跑起来了，但是vite的特性是你用到的页面才会进行打包，其他页面没有进行访问，是不会打包的，所以需要进行打包才能知道其他地方改造会不会有问题，打包如果有报错，再解决报错即可。

.解决报错

       globalisnotdefined

       这个错误是在node_modules/buffer/index.js?v=ea7文件中抛出的，我查看了yarn.lock文件，依赖路径为多个vue-cli插件>webpack@4.0.0>node-libs-browser?>buffer

       这个是依赖的问题，第一删除node_modules重新安装依赖。第二更换npm工具为pnpm重装依赖，如果仍不行，建议不建议webpack，删除掉webpack相关依赖。

       网上还有一种做法是：在window对象上挂载global对象，可作为备选方案。

import?{ ?defineConfig?}?from?'vite'export?default?defineConfig({ })6

       @import'~@vant/icons/src/encode-woff2.less';报错

       这个错误是vant组件库中的icon组件抛出的，vite默认不能使用别名，我们在前面配置了别名，但是配置的是~@指向项目中的src目录，这样vant组件库的这个文件引用就找不到了。

       issuesvant

       解决方法：针对vant的这个文件，做一个别名，放到第一位，优先进行匹配：

import?{ ?defineConfig?}?from?'vite'export?default?defineConfig({ })7

       运行vitebuild，css产生了一些警告。

       警告分为两种，一是css中的属性拼写错误，诸如：color写成了colo，background写成了backgrounc，属于语法错误，根据警告提示搜索对应样式进行修改即可。

       二是一些语法正确，但还不清楚为什么压缩时提示了警告：比如stylus修改scoped样式用的>>>语法，以及background?rgba(0,0,0,0.5)提示Unexpected"rgba("。

       Thepackagemayhaveincorrectmain/module/exportsspecifiedinitspackage.json

       这个错误是通过npminstall后运行vite指令报错的，用yarn安装一直很正常，原因是node_modules的某个包的package.json定义的main入口路径错了，所以找不到模块导入。

       解决方法：针对这个模块，定义别名，指向正确的入口：

import?{ ?defineConfig?}?from?'vite'export?default?defineConfig({ })8

       打包后导入函数定义别名后，调用函数报错

       import*asminByfrom'lodash.minby'代码报错了，而且只有在生产环境下才产生。

       解决方法：暂时去掉别名，这应该和lodash的导出方式modules.export在vite中转化成ES语法的过程有关系。

       importminByfrom'lodash.minby'

       requireisnotdefine，通过require导入资源报错

       前面在步骤5已经用了插件vite-plugin-commonjs转化common.js的代码了，require理应不会报错。

       但是require导入资源算是webpack的功能，和js代码不一样，所以导入资源的代码都要进行修改：

       require('./images/logo.png')改成importlogofrom'./images/logo.png'

       这样的修改可以兼容webpack和vite，这是在现有项目中，改动的地方会达到上百处，非常麻烦。