feat: parse file preserve symlink path (#2030)

Signed-off-by: Peefy <xpf6677@163.com>

Author: Peefy

crates/api/src/service/service_impl.rs

@@ -180,7 +180,7 @@ impl KclServiceImpl {
     /// assert_eq!(result.deps.len(), 2);
     /// ```
     pub fn parse_file(&self, args: &ParseFileArgs) -> anyhow::Result<ParseFileResult> {
-        let file = canonicalize_input_file(&args.path, "");
+        let file = canonicalize_input_file(&args.path, "", false);
         let result = parse_single_file(&file, transform_str_para(&args.source))?;
         let ast_json = serde_json::to_string(&result.module)?;
 

crates/parser/src/entry.rs

@@ -302,7 +302,7 @@ pub fn get_compile_entries_from_paths(
     let mut k_code_queue = VecDeque::from(opts.k_code_list.clone());
     let file_paths = expand_input_files(file_paths);
     for file in &file_paths {
-        let file = canonicalize_input_file(file, &opts.work_dir);
+        let file = canonicalize_input_file(file, &opts.work_dir, opts.preserve_symlink_paths);
         let path = ModRelativePath::from(file.to_string());
 
         // If the path is a [`ModRelativePath`] with prefix '${<package_name>:KCL_MOD}',
@@ -425,12 +425,17 @@ fn get_main_files_from_pkg_path(
         }
     }
 
-    match PathBuf::from(s.clone()).canonicalize() {
-        Ok(path) => {
-            path_list.push(path.to_str().unwrap().to_string());
+    // When preserve_symlink_paths is true, don't canonicalize (resolves symlinks)
+    if opts.preserve_symlink_paths {
+        path_list.push(s);
+    } else {
+        match PathBuf::from(s.clone()).canonicalize() {
+            Ok(path) => {
+                path_list.push(path.to_str().unwrap().to_string());
+            }
+            // path from virtual file system
+            Err(_) => path_list.push(s),
         }
-        // path from virtual file system
-        Err(_) => path_list.push(s),
     }
 
     // get k files
@@ -525,7 +530,18 @@ fn is_ignored_file(filename: &str) -> bool {
 }
 
 /// Normalize the input file with the working directory and replace ${KCL_MOD} with the module root path.
-pub fn canonicalize_input_file(file: &str, work_dir: &str) -> String {
+pub fn canonicalize_input_file(file: &str, work_dir: &str, preserve_symlink_paths: bool) -> String {
+    // If preserve_symlink_paths is true, don't canonicalize (resolves symlinks)
+    if preserve_symlink_paths {
+        if !std::path::Path::new(file).is_absolute() {
+            return std::path::Path::new(work_dir)
+                .join(file)
+                .to_string_lossy()
+                .to_string();
+        }
+        return file.to_string();
+    }
+
     let path = std::path::Path::new(file);
     let is_absolute = path.is_absolute();
     // If the input file or path is a relative path and it is not a absolute path in the KCL module VFS,

crates/parser/src/lib.rs

@@ -264,6 +264,11 @@ pub struct LoadProgramOptions {
     pub load_packages: bool,
     /// Whether to load plugins
     pub load_plugins: bool,
+    /// Whether to preserve symlink paths instead of resolving them.
+    /// When true, file paths are used as-is without canonicalization.
+    /// This is important for LSP and other tools that need to maintain
+    /// the original file paths as provided by the user/editor.
+    pub preserve_symlink_paths: bool,
 }
 
 impl Default for LoadProgramOptions {
@@ -276,6 +281,7 @@ impl Default for LoadProgramOptions {
             mode: ParseMode::ParseComments,
             load_packages: true,
             load_plugins: false,
+            preserve_symlink_paths: false,
         }
     }
 }

crates/tools/src/LSP/src/compile.rs

@@ -43,6 +43,9 @@ pub fn compile(
     // Ignore the kcl plugin sematic check.
     let mut opts = opts.unwrap_or_default();
     opts.load_plugins = true;
+    // Preserve symlink paths for LSP - don't resolve symlinks to maintain
+    // the original file paths as provided by the editor
+    opts.preserve_symlink_paths = true;
     // Get input files code from vfs
     let normalized_files = match get_normalized_k_files_from_paths(files, &opts) {
         Ok(file_list) => file_list,