ITStudio_OUC/OxideJS-New
0
1
Fork 0
mirror of https://github.com/pjh456/OxideJS.git synced 2026-10-26 11:41:13 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs: 收敛结构哈希绑定名口径注释

Browse Source
This commit is contained in:
彭俊皓
2026-09-17 14:53:41 +00:00
parent 048fb145fa
commit 21348be840
1 changed files with 4 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files
crates/oxide_compiler/src/hash/mod.rs
+4 -3
View File
@@ -2,9 +2,10 @@
//! `Program` 的稳定哈希，用作编译缓存键（code cache）。 //! `Program` 的稳定哈希，用作编译缓存键（code cache）。
//! //!
//! `structural_hash` 为粗粒度键，忽略变量声明名、标识符读、import 本地名与 //! `structural_hash` 为粗粒度键，忽略变量声明名、标识符读、import 本地名与
//! 函数参数等大部分绑定名；`compiled_module_hash` 为精确键，额外纳入全部绑定名。 //! 函数参数等大部分绑定名；`compiled_module_hash` 为精确键，额外纳入标识符形态的绑定名
//! （变量声明、参数与 catch 的解构形态均不贡献哈希）。
//! 函数声明名、类名与 catch 参数标识名是编译产物物化名，两种粒度下恒计入哈希； //! 函数声明名、类名与 catch 参数标识名是编译产物物化名，两种粒度下恒计入哈希；
//! catch 参数为解构形态时不贡献哈希。 //! 变量声明、函数/箭头/方法参数与 catch 参数为解构形态时均不贡献哈希。
use oxide_parser::{ use oxide_parser::{
ArrayExpressionElement, BindingPattern, ChainElement, Class, ClassElement, Declaration, ArrayExpressionElement, BindingPattern, ChainElement, Class, ClassElement, Declaration,
@@ -50,7 +51,7 @@ pub fn structural_hash(program: &oxide_parser::Program) -> u64 {
hash_program(program, false) hash_program(program, false)
} }
/// 精确编译模块哈希：在粗粒度键基础上额外纳入全部绑定名， /// 精确编译模块哈希：在粗粒度键基础上额外纳入标识符形态的绑定名，
/// 避免绑定名不同但结构相同的程序错误复用缓存。 /// 避免绑定名不同但结构相同的程序错误复用缓存。
pub fn compiled_module_hash(program: &oxide_parser::Program) -> u64 { pub fn compiled_module_hash(program: &oxide_parser::Program) -> u64 {
hash_program(program, true) hash_program(program, true)