_轻舟_-CSDN博客

原创 IndexedDB 完整教程：从基础 API 到离线应用实战（附源码）

IndexedDB是浏览器提供的本地NoSQL数据库，支持大容量结构化数据存储、异步操作和索引查询。相比有限的localStorage，它可存储数GB数据，适合离线应用和复杂查询场景。核心概念包括数据库、对象仓库（表）、索引和事务，所有操作需在事务中执行。原生API基于回调，推荐封装为Promise形式简化使用。通过版本升级机制可修改数据库结构，如新增表或索引。IndexedDB特别适合需要本地存储大量结构化数据的Web应用，能显著提升性能和用户体验。

2026-06-17 17:13:57 455

原创 Git 分支合并规范：如何优雅地把功能分支合入主分支

本文针对多人协作开发中的分支合并问题，提出了一套标准操作流程，帮助实现个人分支历史纯净、主分支线性历史和合并粒度可控。流程包含8个步骤：确定合并范围→同步主分支→创建临时分支→cherry-pick精选提交→压缩为单commit→推送临时分支→合并到主分支→清理临时分支。通过使用临时分支缓冲、cherry-pick精选代码并压缩合并，既保持了主分支的线性历史，又保留了功能分支的完整记录。文末提供了快速参考命令和流程图解，适合团队协作时统一规范使用。

2026-06-17 16:46:38 430

原创从零搭建离线地图服务：Nginx + Cesium/Leaflet 实战指南

本文介绍了在内网环境下部署离线地图服务的解决方案。通过Nginx配置瓦片服务，支持Cesium和Leaflet两种前端地图引擎加载，实现从本地开发到生产环境的无缝迁移。详细说明了Nginx服务配置、跨域设置以及两种地图引擎的初始化方法，包括坐标参考系选择和瓦片加载方式。该方案仅需更换服务地址即可实现代码复用，有效解决了离线环境下地图服务不可用的问题。文中还提供了相关资源获取方式和部署验证步骤，为内网地图应用开发提供了实用参考。

2026-05-26 09:30:57 409

原创 Cesium 冷门但致命的 FOV 机制：横竖屏自动切换原理

摘要： Cesium三维开发中，横竖屏切换时画面变形是因其独特的FOV（视场角）自动切换机制。不同于常规WebGL，Cesium会根据屏幕比例动态选择水平/垂直FOV以保证跨设备视觉统一。默认机制适用于多数场景，但大屏或VR项目需手动锁定视角：宽屏固定水平FOV，竖屏需反向换算；沉浸式场景则需固定垂直FOV。理解这一机制可解决90%的视角适配问题，避免画面畸变和跳动。核心原则：通用场景依赖默认适配，高精度项目需主动干预FOV逻辑。

2026-05-26 09:29:00 187

原创 Cesium 3D Tiles 加载与优化实战

3D Tiles 是一种开放的空间数据格式规范，用于高效地传输、加载和渲染大规模三维地理空间数据。它由 Cesium 团队提出，旨在解决传统三维模型格式在处理海量数据时的性能瓶颈。3D Tiles 是处理大规模三维地理空间数据的理想解决方案，通过合理的配置和优化，可以在保证视觉效果的同时实现高性能的加载和渲染。掌握 3D Tiles 的加载技术，对于开发数字孪生、智慧城市等现代地理信息应用至关重要。

2026-05-20 16:49:32 559

原创前端必看：视频实际尺寸获取的正确方法与应用价值

提升用户体验，避免画面变形问题优化页面性能，减少布局重排支撑高级视频功能的实现确保跨设备的一致性显示效果通过原生API的 videoWidth 和 videoHeight 属性，结合 loadedmetadata 事件监听，可以简单、高效地获取视频的真实尺寸，为各类视频应用提供可靠的数据基础。

2026-05-20 16:34:01 240

原创 vue3+vite cesium加载报错node_modules/.vite/dep下静态资源找不到

摘要：在Vue3+Vite项目中使用Cesium时，常因静态资源路径问题报错，因为Vite不会自动处理Cesium依赖的WebGL资源。解决方法是通过vite-plugin-cesium插件：安装插件：npm install vite-plugin-cesium；在vite.config.js中引入并配置插件：plugins: [cesium()]；重启项目即可自动处理Cesium的静态资源路径问题。

2025-12-23 16:50:45 289

原创前端开发中的自签名证书难题：Vite代理与浏览器设置的终极解决方案

当项目使用自签名SSL证书部署HTTPS时，浏览器安全机制会阻断访问。本文提供两种前端解决方案：通过Chrome命令行参数全局忽略证书错误，或采用Vite开发服务器配置API代理转发。重点详解Vite的vite.config.js代理设置，利用secure:false参数绕过证书验证，实现开发环境的安全请求转发。方案兼顾开发便捷性与安全性，适用于Vue3+TypeScript技术栈。

2025-12-23 16:35:13 429

原创 docker部署项目时报错no space left on device，处理方法

在服务器使用docker部署项目时报错如下报错含义：在 Docker 构建或加载镜像过程中，系统磁盘空间不足，导致无法写入文件通过清理磁盘空间的方式解决。

2025-07-23 16:55:38 322

原创代码新增一个关联的git仓库，并将当前代码默认提交仓库改成新增的，实现分别向两个git仓库提交代码

操作命令查看远程仓库重命名远程仓库修改远程仓库地址添加新的远程仓库删除远程仓库本地分支关联远程仓库git push --set-upstream <仓库名> <分支名>切换分支默认绑定仓库git branch --set-upstream-to=<远程仓库名>/<远程分支名> <本地分支名>查看分支绑定的仓库代码推送到指定仓库git push <仓库名>

2025-07-23 15:52:30 1111

原创前端npm安装依赖时报错，如何忽略冲突继续安装

安装依赖时如报错这类错误通常发生在：项目依赖的包之间对 peerDependencies 有版本冲突使用了较新版本的 npm（v7+），它默认会尝试自动安装 peerDependencies，但可能引发冲突。

2025-07-23 15:52:09 601

原创使用nginx.exe -t命令检查nginx配置时报错

使用nginx.exe -t命令检查nginx配置时报错如下这个错误表示 Nginx 在尝试创建临时目录 D:\nginx\nginx-1.23.3/temp/client_body_temp 时失败，因为该路径不存在。

2025-07-23 11:32:35 334

原创 nginx常用命令，检查配置，启动，检查是否启动成功等

添加后可以在任意路径执行 nginx 命令1、打开系统属性：按 Win + R 输入 sysdm.cpl 回车或在"此电脑"右键 → 属性 → 高级系统设置2、点击环境变量按钮3、在系统变量区域找到 Path 变量，点击编辑4、点击新建，添加 Nginx 安装路径，如：D:\nginx\nginx-1.23.35、点击确定保存所有对话框6、重启命令。

2025-07-23 11:32:21 1073

原创 git历史commit中有大文件，提交报错，清除以前的commit记录，只提交最新代码的方法

git项目中引入了一个大文件如大于100M，提交到仓库的时候报错文件过大无法提交，删除大文件之后，重新提交，还是会把之前包含大文件的commit一起提交。4、删除旧的分支（假设原分支名为 test-root）1、创建全新孤立分支（无历史记录）2、添加当前所有文件到暂存区。5、将新分支重命名为原分支名。7、强制推送（覆盖远程历史）

2025-07-18 15:47:51 359

原创 vue3引入cesium完整步骤

2、将node_modules中cesium目录下的Build/Cesium 中 Assets、ThirdParty、Workers复制到public。将Widgets目录复制到src目录下，如assets目录。4、设置cesium静态资源路径。5、设置cesium token。1、安装cesium。3、引入cesium。

2025-07-18 14:48:01 523

原创 cesium添加热力图和透明实体之后，热力图被遮挡，解决方案

在使用Cesium渲染热力图和透明实体时，透明实体会默认后渲染，导致热力图被遮挡。为解决此问题，可以采取以下两步：首先，在初始化viewer时关闭透明物体的独立排序，通过设置orderIndependentTranslucency: false实现。其次，为热力图添加离地高度，即使高度值设置较小，也能避免被实体遮挡。具体操作可在CesiumHeatmap.js源码中修改CHInstance.prototype.updateLayer方法，设置rectangle的height属性。通过这两步调整，热力图将不再

2025-05-09 09:06:33 531

原创 cesium报错： Failed to execute ‘postMessage‘ on ‘Worker‘:Lobject Array] could not be cloned

cesium地图加载时报错：DataCloneError: Failed to execute ‘postMessage’ on ‘Worker’:Lobject Array] could not be cloned。cesium实例不能设置为响应式属性，Cesium的核心类（如Viewer、Entity）采用基于WebGL的渲染机制，其内部状态管理独立于前端框架的响应式系统。

2025-05-09 09:04:16 839